---
title: "Create an AI tabletop adventure generation job"
method: POST
path: "/v1/ttrpg"
tags: ["AI Tabletop"]
---

# Create an AI tabletop adventure generation job

`POST /v1/ttrpg`

## Request

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

## Request body

- CreateTtrpgAdventureDto
  - `prompt` string, required
  - `templateSlug` string
  - `setting` string
  - `tone` 'heroic' | 'dark' | 'cozy' | 'weird' | 'mystery'
  - `length` 'micro' | 'short' | 'one_shot' | 'medium' | 'long': micro=1 scene, short=2, one_shot=3, medium=4, long=6. Credit cost scales with length.
  - `artStyle` string
  - `railsLevel` number
  - `partyFantasy` string

## Response `201`

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