---
title: "Create a reusable player character (AI sheet + portrait, async)"
method: POST
path: "/v1/ttrpg/characters"
tags: ["AI Tabletop"]
---

# Create a reusable player character (AI sheet + portrait, async)

`POST /v1/ttrpg/characters`

## Request

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

## Request body

- CreateTtrpgCharacterDto
  - `concept` string, required: Free-text concept for the character (up to 6000 characters). The AI turns this into a full light stat sheet, portrait, and token. Example: "a grizzled dwarven storm-priest who lost her faith".
  - `name` string: Optional character name. If omitted, the AI invents a fitting one.
  - `artStyle` string: Optional art-style direction for the portrait. Defaults to a clean painted fantasy character style.

## Response `201`

Character queued for generation

## Other responses

- `402`: 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)