Creative
Betacreative_generate_video
Start a video generation job in the connected workspace.
Operation: Write. Requires read-and-write OAuth consent.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Video generation input. |
body.model | string | Yes | Model ID from creative_video_models_list. |
body.prompt | string | No | Describe the video to create or the change to make. Check the model’s prompt and reference requirements. |
body.duration_seconds | integer | No | Output length in seconds. Use a duration supported by the model. |
body.mode | string | No | Use async to receive a job immediately. |
idempotency_key | string | Yes | Use a unique key per action. Reuse it to retry identical input. |
approval_receipt | string | No | Receipt returned with the plan. Supply it after user confirmation. |
Use creative_video_models_get to check input requirements and pricing before selecting a model.
The first call returns a plan. After confirmation, resubmit the same input with its approval_receipt. The job calls an external provider and can consume Creative credits. Pass data.job.id to creative_jobs_wait, then retrieve the output with creative_jobs_result.
Sample prompt
Generate a five-second video of clouds moving over a meadow. Wait for the job and return the video URL.