Create Tileset
Generate tilesets for top-down, sidescroller, and isometric games.
Create Tileset
Generate game tilesets with AI. Choose from top-down, sidescroller, or isometric perspectives. Each tileset includes inner tiles (floor/ground) and outer tiles (walls/borders).
Endpoints
| Variant | Endpoint |
|---|---|
| Top-down | POST /api/tilesets/create-top-down |
| Sidescroller | POST /api/tilesets/create-sidescroller |
| Isometric | POST /api/tilesets/create-isometric |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
inner_description | string | Yes | Description of floor/ground tiles |
outer_description | string | Yes | Description of wall/border tiles |
tile_size | integer | No | Tile dimensions in pixels. Default: 16 |
border | object | No | Border configuration for tile transitions |
tile_count | integer | No | Number of unique tiles to generate. Default: 16 |
seed | integer | No | Random seed. 0 = random |
Border Configuration
{
"border": {
"enabled": true,
"width": 2,
"color": "#000000"
}
}Example
curl -X POST https://api.spritesynth.com/api/tilesets/create-top-down \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inner_description": "dirt floor with scattered pebbles",
"outer_description": "mossy stone walls",
"tile_size": 16,
"border": { "enabled": true, "width": 1 },
"seed": 42
}'Response
{
"id": "tileset_abc",
"status": "completed",
"tileset": {
"id": "ts_xyz",
"type": "top_down",
"tile_size": 16,
"tile_count": 16,
"tiles_url": "https://cdn.spritesynth.com/tilesets/ts_xyz_tiles.png",
"atlas_url": "https://cdn.spritesynth.com/tilesets/ts_xyz_atlas.json"
},
"credits_cost": 5,
"duration_ms": 8000
}Tips
- Use
tile_size: 16for retro games,32for modern pixel art. - Generate inner and outer tiles separately for more control.
- Export for Tiled, Unity, or Godot.
Need help?
Join our Discord community for support and tips.
Was this page helpful?