Create a character episode
create_character_episodeMake the episode: 3-8 shots, 12-60 seconds, the same fictional character in every shot, narrated with captions. CHARGES credits (up to 313 credits for a default 12-second episode; longer ones (up to 60 seconds) cost more). ALWAYS call quote_character_episode first and tell the human the price: the human, not the agent, decides to spend. This tool refuses unless confirm is true, expectedCredits equals the price computed now (a changed price answers 409 PRICE_CHANGED and charges nothing) and idempotencyKey is set; StoryShort has no daily spending cap per key, so these are the guard. The series must have a REVIEWED, CONFIRMED season plan and the episode must be one of its episodes exactly as planned (SEASON_PLAN_REQUIRED / SEASON_NOT_REVIEWED / EPISODE_NOT_IN_PLAN otherwise, with a nextAction, nothing charged); the narrator voice, language, style, look and outfit come from the plan. Credits are held when it starts. A shot that cannot be animated keeps a still image and its clip credits go back; if too few shots move, or anything else fails, everything goes back. Characters are fictional adults (or animals / mascots), AI-generated: no real or famous people, no children or anyone who looks under 18, no sexual content, no logos or protected characters (refused with CONTENT_POLICY, nothing charged). Everything made here is AI-generated and labelled as such. Takes about 10-25 minutes: poll get_video with arguments { id: <the returned id / videoId> }; it reports status, stage and, when COMPLETED, videoUrl. One episode at a time per account. Requires the "video:create" scope.
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": {
"seriesId": "<seriesId>",
"confirm": "<confirm>",
"expectedCredits": "<expectedCredits>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "create_character_episode"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shots | No | The shots of the planned episode. Give `shots` OR `script`. | |
| title | No | Optional title. | |
| script | No | The narration, about 29-147 words. The system splits it into shots by sentence. Give `script` OR `shots`, exactly as planned (get_season_plan). | |
| confirm | Yes | Must be true: making an episode spends credits, and the human has seen the price. | |
| sheetId | No | Omit it: the character sheet is the one the season plan names for this episode. If given it must equal that sheet. | |
| language | No | Omit it: the narration language is the season plan's. If given it must equal the plan's. | |
| seriesId | Yes | A series id from list_series whose season plan is reviewed and confirmed. | |
| shotCount | No | With `script`: how many shots to split it into. Omit for an automatic count. | |
| idempotencyKey | Yes | Required. One new unique key per purchase; a repeat with the same key returns the first answer (replayed: true) and charges nothing. | |
| expectedCredits | Yes | The credits the quote showed the human. Must match the price computed now. |