---
title: creative_generate_video
description: Start a video generation job in the connected workspace.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_generate_video
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_generate_video.md
contentType: reference
---

# creative_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

```text
Generate a five-second video of clouds moving over a meadow. Wait for the job and return the video URL.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
