About this endpoint
What it does
Generates a short video from a text prompt and starts the job asynchronously. The request body contains the generation settings, and the response returns a task identifier you can use to track the job.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| prompt | String | Yes | The text description of the video to generate. |
| cfg | Number | No | Guidance scale. Default: 1. 1.0 is recommended for the distilled model. |
| seed | Integer | No | Random seed for reproducible generation. Default: 0. |
| steps | Integer | No | Number of inference steps. Default: 8. Minimum: 1. Maximum: 15. |
| width | Integer | No | Output video width in pixels. Default: 768. Minimum: 256. Maximum: 1024. |
| height | Integer | No | Output video height in pixels. Default: 512. Minimum: 256. Maximum: 1024. |
| length | Integer | No | Video duration in frames at 25 fps. Default: 97. Minimum: 9. Maximum: 161. Snapped to a valid n*8+1 value. |
| negative_prompt | String | No | What to avoid in the generated video. Default: "". |
Response
Returns a JSON object with status, message, and task_id string fields. The task_id field contains the identifier for the asynchronous job.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| status | String | No | Job status. |
| message | String | No | Additional message about the request or job. |
| task_id | String | No | The job identifier to use when checking progress. |
Notes
This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Extract the job id from task_id.