Submit video generation job

Async — returns the job id. Poll GET /videos/{id} for status, then download via GET /videos/{id}/download once status=completed. Provider URLs are never exposed; the download endpoint is the only way to fetch the MP4.

POST /videos

Submit video generation job

cURL

curl --request POST \
  --url https://api.runcrate.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "duration_seconds": 123,
  "image_url": "<string>",
  "aspect_ratio": "16:9"
}
'

200

{
  "id": "<string>"
}

Authorizations

Authorization · string · header · required

Use a Runcrate API key with the rc_live_* prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys.

Body

application/json

model · string · required

Video model id (e.g. openai/sora-2).

prompt · string · required

duration_seconds · integer

Seconds; varies by model.

image_url · string<uri>

Optional image-to-video reference.

aspect_ratio · string

Example:

"16:9"

Response

200

application/json

Video job queued. Poll GET /videos/{id} for status.

id · string · required

Job id to poll.

status · enum<string> · required

Available options: queued, processing, completed, failed