Edit Animation
Modify existing animations with natural language instructions.
Edit Animation
Modify existing animations using natural language. Describe what you want changed and the model will update the animation accordingly.
Endpoint
POST /api/animations/edit-animation-v2Parameters
| Name | Type | Required | Description |
|---|---|---|---|
animation | string | Yes | Animation GIF URL or base64-encoded sprite sheet |
description | string | Yes | Natural language description of the edit |
edit_type | string | Yes | Type of edit: speed, style, smoothness, frames |
Edit Types
| Type | Description |
|---|---|
speed | Change animation speed (faster/slower) |
style | Change the visual style of the animation |
smoothness | Adjust frame transitions and interpolation |
frames | Add, remove, or reorder frames |
Example
curl -X POST https://api/animations/edit-animation-v2 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"animation": "https://cdn.spritesynth.com/animations/anim_123.gif",
"description": "make the sword swing more dramatic",
"edit_type": "style"
}'Response
{
"id": "edit_anim_789",
"status": "completed",
"animation": {
"url": "https://cdn.spritesynth.com/animations/edit_anim_789.gif",
"sprite_sheet": "https://cdn.spritesynth.com/animations/edit_anim_789_sheet.png",
"frame_count": 8,
"fps": 12
},
"credits_cost": 2,
"duration_ms": 3200
}Tips
- Be specific about what to change — "slow down the walk cycle" works better than "change speed".
- Use
speedfor tempo adjustments,stylefor visual changes. - Editing preserves the original frame count unless
framestype is used.
Need help?
Join our Discord community for support and tips.
Was this page helpful?