Prepare a variant (quote)
request_variantStep 1 of 2: nothing is charged. Prices a variant of a ready video: translate (languages), reformat (aspect ratios, recomposed not cropped), recreate (new takes with the same settings, or another pace, the project's code screens and Brand Kit included, priced like the web app's Recreate) or export_4k. Returns a quote_id for confirm_operation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video_id": "<video_id>",
"kind": "<kind>"
},
"name": "request_variant"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| pace | No | recreate: the new takes' pace, calm (Calm), normal (Balanced) or fast (Punchy), e.g. a calmer take of a film that feels too fast. Default: the pace the project's films were made at. Same price. | |
| count | No | recreate: how many new takes. | |
| aspects | No | reformat: target aspect ratios. | |
| video_id | Yes | ||
| voice_id | No | translate: a voice from get_options (default: the video's voice when it is a native speaker of the language, else a native voice of the language). | |
| languages | No | translate: target language codes (get_options). | |
| visibility | No | Default: the same as the source video (recreate: the project's choice if it made one; a project made from code starts private). | |
| review_storyboard | No | recreate: pause after each new take's storyboard for approve_storyboard. Default: the project's create_project review_storyboard, else false (confirm_operation is the only approval; a take still pauses if its price would exceed the quote). |