Create video (Quick Create)
create_videoKick off an ASYNC full video production job (the Quick Create flow). SPENDS CREDITS (dynamic, ~50–200 by duration/type — the exact amount comes back as creditsReserved). Returns a jobId; poll get_job until completed. For UGC video types ('ugc','brainrot','ugc-broll','ugc-demo') you MUST supply a script and a characterId: a saved actor from list_characters / list_character_library, or "auto" to let VidGuy pick a talking-head actor whose setting, gender and age fit the script (free; saved as a character on the account). With "auto" the response carries characterId + actorPick {picker, fit, setting} — pass that characterId on the next videos to keep the same actor across a campaign. Credits refunded automatically on failure.
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": {
"topic": "<topic>",
"durationSeconds": "<durationSeconds>",
"platform": "<platform>",
"videoType": "<videoType>"
},
"name": "create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | What the video is about | |
| script | No | UGC only: the spoken script/dialogue | |
| platform | Yes | ||
| videoType | Yes | ||
| characterId | No | UGC only: character/actor id from list_characters, or "auto" to pick an actor that fits the script | |
| scenePrompt | No | UGC only: optional scene direction | |
| durationSeconds | Yes | Target length in seconds | |
| additionalInstructions | No |