Create mascot
create_mascotGenerates a new mascot character from a description (2 credits, charged only on success). Returns a generation_id immediately; poll it with check_generation (about 10-40 seconds). The mascot anchors every later pose and animation, so describe species, personality and look in one sentence.
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": {
"description": "<description>"
},
"name": "create_mascot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional display name for the mascot. | |
| style | No | Optional art direction, e.g. 'flat vector', 'soft 3d', 'pixel art', 'line art'. | |
| description | Yes | The character, e.g. 'a cheerful blue elephant plumber with a tiny red cap'. | |
| reference_pose_id | No | Optional pose id from get_board to use as an additional visual reference. | |
| reference_mascot_id | No | Optional mascot id from get_board to build on, so a recolour or restyle keeps the original design. Describe the character itself rather than only the change: this description is reused for every later pose, and 'a blue version of that one' carries no appearance into them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| note | No | ||
| status | Yes | ||
| target | No | ||
| next_step | No | ||
| generation_id | Yes | ||
| cost_on_success | No | ||
| expected_seconds | No |