---
title: "Generate a custom AI tile"
method: POST
path: "/v1/tile-packs/generate"
tags: ["Tile Packs — Custom Generation"]
---

# Generate a custom AI tile

`POST /v1/tile-packs/generate`

## Request

- Base URL: `https://api.sprixen.com`
- URL: `https://api.sprixen.com/v1/tile-packs/generate`
- Auth: `bearer` (a scheme the document does not define)

## Request body

- CreateCustomTileDto
  - `prompt` string, required: Prompt describing the tile texture. Max 6000 characters.
  - `tileLabel` string: Display name for the tile
  - `collision` 'walkable' | 'solid' | 'water'
  - `projectionType` 'isometric' | 'top_down' | 'side_view'
  - `category` 'terrain' | 'decoration' | 'entity': Tile category — affects positioning rules for side-view tiles
  - `footprintW` number: Number of grid columns this tile occupies (multi-tile footprint width)
  - `footprintH` number: Number of grid rows this tile occupies (multi-tile footprint height)
  - `webhookUrl` string: Optional webhook URL — receives a POST when tile generation completes or fails
  - `flatOnly` boolean: If true, returns only the flat diamond top face without 3D side faces (isometric only)

## Response `201`

Generation job queued

## Other responses

- `402`: Credit limit reached or insufficient credits

---

[API](https://skmtc.dev/sprixen/apis/sprixen-api.md) · [All operations](https://skmtc.dev/sprixen/apis/sprixen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprixen/apis/sprixen-api/revisions/6c0c57f6da58?raw)