Edit the video direction and render settings
update_video_directionChange the creative plan and render settings for a product's upcoming video before generation. Only the fields you provide are updated, preserving current values.
Instructions
Edit the creative direction and render settings for a product's next video. Only the fields you pass are changed; everything else keeps its current value.
creative_direction is the plan the render is built from. It is free
text, but the drafts follow a six-section shape that works well and is
worth preserving when editing:
Hook: ... Content Focus: ... Format: ... Execution Guidelines: ... Strict Guidelines & Restrictions: ...
Do not invent a direction from nothing when one has not been drafted
yet — call redraft_video_direction and edit what comes back. Leaving
it empty is also valid: generation works without a direction.
creator_note is different and smaller: the user's own short note to
the director ("mention it is machine washable", "for Father's Day"). It
is carried through to the render verbatim, so put the user's words in
it, not your paraphrase.
Only works before generation starts. This does not spend credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ratio | No | Aspect ratio. 9:16 (vertical) is the default and what social feeds want. | |
| product_id | Yes | The product's id. | |
| resolution | No | 1080P needs a paid plan; a pick above the plan's ceiling quietly becomes that ceiling (the response reports what was actually saved). | |
| creator_note | No | The user's short note to the director, max 1000 characters. | |
| enable_audio | No | Whether the render has sound. | |
| target_market | No | Free text, e.g. "US/North America" or "Japan". Drives the spoken language unless one is set explicitly. Saved on the brand, so it carries to later videos. | |
| creative_direction | No | The full creative plan, max 3000 characters. Pass an empty string to clear it. |