Create Character
Create multi-directional character sprites for games.
Create Character
Generate multi-directional character sprites. Supports 4-directional (front, back, left, right) and 8-directional character generation for top-down and isometric games.
Endpoints
| Variant | Endpoint |
|---|---|
| 4-directional | POST /api/generations/create-character-with-4-directions |
| 8-directional | POST /api/generations/create-character-with-8-directions |
| v3 (latest) | POST /api/generations/create-character-v3 |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
description | string | Yes | Text prompt describing the character |
direction_count | integer | No | 4 or 8. Default: 4 |
image_size | string | No | Size per direction tile as WxH. Default: 128x128 |
seed | integer | No | Random seed. 0 = random |
palette | string | No | Target color palette |
Example
curl -X POST https://api.spritesynth.com/api/generations/create-character-v3 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "a pixel art mage character with purple robes and staff",
"direction_count": 4,
"image_size": "128x128",
"seed": 42
}'Response
{
"id": "char_abc",
"status": "completed",
"character": {
"id": "chr_xyz",
"directions": {
"south": "https://cdn.spritesynth.com/characters/chr_xyz_south.png",
"north": "https://cdn.spritesynth.com/characters/chr_xyz_north.png",
"east": "https://cdn.spritesynth.com/characters/chr_xyz_east.png",
"west": "https://cdn.spritesynth.com/characters/chr_xyz_west.png"
},
"sprite_sheet": "https://cdn.spritesynth.com/characters/chr_xyz_sheet.png"
},
"credits_cost": 4,
"duration_ms": 6000
}Tips
- Use
direction_count: 4for top-down games,8for isometric. - 8-directional costs more credits but gives smoother rotation.
- Follow up with Character States to add animations.
Need help?
Join our Discord community for support and tips.
Was this page helpful?