Creative
Beta

creative_generate_video

Start a video generation job in the connected workspace.

Operation: Write. Requires read-and-write OAuth consent.

Parameters

ParameterTypeRequiredDescription
bodyobjectYesVideo generation input.
body.modelstringYesModel ID from creative_video_models_list.
body.promptstringNoDescribe the video to create or the change to make. Check the model’s prompt and reference requirements.
body.duration_secondsintegerNoOutput length in seconds. Use a duration supported by the model.
body.modestringNoUse async to receive a job immediately.
idempotency_keystringYesUse a unique key per action. Reuse it to retry identical input.
approval_receiptstringNoReceipt 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.