create_character_animation
Animate a saved pixel art character by ID using template, v3, or pro modes. Supports custom actions and frame interpolation for flexible animations.
Instructions
Animate a SAVED character by ID with flexible modes. mode='template' uses a skeleton-based template_animation_id; mode='v3' interpolates frames from a custom action_description (4-16 frames); mode='pro' is the pro animator. More flexible than animate_character, which is template-only. Requires a character_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Animation mode: 'template' (skeleton from template_animation_id), 'v3' (custom action), 'pro' | |
| seed | No | Seed for deterministic generation (default 0) | |
| detail | No | Detail level | |
| outline | No | Outline style | |
| shading | No | Shading style | |
| isometric | No | Generate in isometric view (default false) | |
| directions | No | Directions to animate (south, north, east, west, etc.), or omit for default | |
| color_image | No | Color palette reference image | |
| description | No | Character description (uses character's original if omitted) | |
| frame_count | No | Number of frames (4-16, must be even, default 8). v3 mode only | |
| character_id | Yes | ID of existing character to animate | |
| force_colors | No | Force use of colors from color_image (default false) | |
| animation_name | No | Name for this animation (defaults to action_description) | |
| enhance_prompt | No | Auto-expand the description into a richer prompt before generating (default false) | |
| action_description | No | Action description (required for custom v3/pro animations, e.g. 'walking', 'jumping') | |
| text_guidance_scale | No | How closely to follow the text (1.0-20.0, default 8) | |
| template_animation_id | No | Animation template ID (required for template mode, e.g. 'walking', 'attack') |