animate_with_text_v2
Animate character images using text descriptions of actions. Provide a reference image and action text to generate animated frames from pixel art characters.
Instructions
RECOMMENDED animation tool — animate a character image with a text-described action. Provide a reference image + action text. 32-256px. Frames by size: 32-64px → 16, 128-256px → 4. Use this when you have a character image but NOT a saved character ID. If you have a character ID, use animate_character instead.
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": {
"reference_image": "<reference_image>",
"reference_image_size": "<reference_image_size>",
"action": "<action>",
"image_size": "<image_size>"
},
"name": "animate_with_text_v2"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for deterministic generation (default 0) | |
| view | No | Camera perspective (default 'none') | |
| action | Yes | Action to animate (e.g. 'walk', 'cast spell') | |
| direction | No | Facing direction (default 'none') | |
| image_size | Yes | Output frame size (32x32 to 256x256) | |
| no_background | No | Generate with transparent background | |
| reference_image | Yes | Character image to animate with dimensions | |
| reference_image_size | Yes | Character image dimensions |