Create a character sheet
create_character_sheetMake a character sheet for one of your series: 4-6 AI images (default 5: front portrait, full body, side, expressions) of ONE fictional character, from a text description. CHARGES credits: 23 credits for 5 images of a person, 11 for an animal or mascot. ALWAYS call get_character_sheet 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. Credits are taken when it starts and returned in full if no sheet comes back. If a non-primary view could not be made in time, the sheet still comes back with the images that exist (the answer says partial: true and lists missingViews) and only those images are charged: the difference is returned and creditsCharged shows what was kept. For a person the face is carried from the front portrait into the other views; the outfit follows the description and can drift a little. For an animal or mascot the views share one description and seed, so they look alike but are not guaranteed to be identical. Usually under a minute; the answer already contains the images (a slow image model fails the call and returns the credits). 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. A series can hold 3 sheets in total; the first sheet is chosen automatically. A series made with create_series has no saved character description: pass description. 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_sheet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | Must be true: making a sheet spends credits, and the human has seen the price. | |
| seriesId | Yes | A series id from list_series. | |
| imageCount | No | Images in the sheet (default 5). | |
| description | No | The character's look: age band, hair, outfit, colours. Omit to use the series' saved character description. | |
| subjectKind | No | PERSON (fictional adult, default), ANIMAL (pet) or MASCOT. | |
| 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 price the human saw (get_character_sheet quotes for this kind and image count). Must equal the price computed now. |