API reference

Video

POSThttps://api.oneover.com/functions/v1/api-v1-videoScope: video

Submit an async video generation job. Poll with GET until status is complete or failed. Credits are charged on completion.

Request body

Parameters

Name	Type	Required	Description
`model`	`string`	Yes	Video model ID (Seedance, Grok Imagine Video, LTX, Kling, Gemini Omni, etc.).
`prompt`	`string`	Yes	Scene description (optional only for photo-talk avatar).
`duration`	`number`	No	Clip length in seconds (provider-dependent).
`resolution`	`string`	No	e.g. 480p, 720p, 1080p.
`aspect_ratio`	`string`	No	square, wide, or tall.
`generate_audio`	`boolean`	No	Whether to generate audio (default true where supported).
`reference_image`	`string`	No	Base64 image for image-to-video / avatar.
`reference_video`	`string`	No	Base64 video for restyle / extend / edit.

Submit examples

Request

curl -X POST "https://api.oneover.com/functions/v1/api-v1-video" \
  -H "Authorization: Bearer oo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-1.5-pro",
    "prompt": "A cinematic drone shot over misty mountains at sunrise",
    "duration": 5,
    "resolution": "480p",
    "aspect_ratio": "wide"
  }'

Submit response

200 OK

{
  "request_id": "uuid",
  "status": "processing",
  "model": "seedance-1.5-pro",
  "credits_estimate": 25
}

GEThttps://api.oneover.com/functions/v1/api-v1-video?request_id=Scope: video

Poll a previously submitted job by request_id.

Poll example

cURL

curl "https://api.oneover.com/functions/v1/api-v1-video?request_id=REQUEST_ID" \
  -H "Authorization: Bearer oo_live_YOUR_KEY"

Complete response

200 OK

{
  "request_id": "uuid",
  "status": "complete",
  "model": "seedance-1.5-pro",
  "video_url": "https://...",
  "credits_charged": 25,
  "balance": { "subscription": 14969, "anytime": 5000 }
}