Skip to main content

​
Create Video

Submits an asynchronous video generation job. Video generation is a long-running process, so this endpoint returns immediately with a job ID. Use the Get Video Status endpoint to poll for completion, then Download Video to retrieve the result. 
POST https://api.runcrate.ai/v1/videos

​
Request Body

ParameterTypeRequiredDescription
modelstringYesThe video generation model to use.
promptstringYesA text description of the video to generate.
durationnumberNoDuration of the video in seconds.
aspect_ratiostringNoAspect ratio of the output video (e.g., 16:9, 9:16, 1:1).

​
Example Request

curl https://api.runcrate.ai/v1/videos \
  -H "Authorization: Bearer rc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-ai/Wan2.1-T2V-14B",
    "prompt": "A drone flying over a mountain range at golden hour",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

​
Response

{
  "id": "vid_abc123",
  "status": "queued"
}
FieldTypeDescription
idstringUnique identifier for the video generation job.
statusstringInitial status of the job. Always queued on creation.

​
Next Steps

After submitting a video job:
  1. Poll GET /v1/videos/ until status is completed or failed.
  2. Once completed, download the video from GET /v1/videos//download.