---
title: "Render an 8-direction sprite sheet of a completed character"
method: POST
path: "/v1/character-studio/characters/{id}/sprite-sheet"
tags: ["Character Studio 3D"]
---

# Render an 8-direction sprite sheet of a completed character

`POST /v1/character-studio/characters/{id}/sprite-sheet`

## Request

- Base URL: `https://api.sprixen.com`
- URL: `https://api.sprixen.com/v1/character-studio/characters/{id}/sprite-sheet`
- Auth: `bearer` (a scheme the document does not define)

Cost: 4 credits per animation type (refunded on technical failure). Creates a Sprite (frame 0 of "down") with 8 Animation rows, one per direction. Poll GET /character-studio/sprite-renders/:id.

## Path parameters

- `id` string, required

## Request body

- CreateSpriteSheetDto
  - `animationType` 'idle' | 'walk' | 'run' | 'attack' | 'jump' | 'death' | 'hurt', required: Sprixen animation type to render. Mapped to the base character action. Produces 8 directions (down, down-left, left, up-left, up, up-right, right, down-right).
  - `frames` number: Frames per direction, 1 to 16. Default 8.
  - `size` number: Frame size in pixels (square), 64 to 256. Default 128. Downscale or pixelate on your side for smaller sprites.
  - `elevation` number: Camera elevation in degrees, 0 (side) to 60 (top-down tilt). Default 30.
  - `projectId` string: Project that receives the generated Sprite. Defaults to the model project, then to your first project.

## Response `201`

Render queued (pending)

## Other responses

- `402`: Insufficient credits
- `404`: Completed character or project not found

---

[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)