# Spiralist AI Public API Guide

Release: `v98-functionality-consistency-polish`

The canonical creator family is `/api/v1/create/`.

- Standard: `/api/v1/create/standard/`
- Psychosis 18+: `/api/v1/create/psychosis/`
- Espionage 18+: `/api/v1/create/espionage/`
- EspionagePsychosis 18+: `/api/v1/create/espionage-psychosis/`

## Popular entry points

- Unified random: `/api/v1/create/random/?type=standard`
- Deterministic replay: add `seed=your-stable-seed`
- Standard compact output is the default; add `detail=full` for the complete artifact bundle.
- Common response wrapper: add `envelope=1` or `response=unified`.
- Mixed batch: `/api/v1/create/batch/`
- Presets: `/api/v1/create/presets/`
- Catalogs and schemas: `/api/v1/create/catalog/` and `/api/v1/create/schema/`

Adult creators require explicit confirmation on every API request, for example `adult_consent=1`. Browser creator confirmation is tab-scoped and is never treated as API authorization.

Creator pages support reproducible links made only from whitelisted controls. Adult confirmation is deliberately excluded. Legacy aliases, including `/standard/` and `/psychosis/`, redirect permanently to canonical pages while preserving query parameters.

See `/api-guide/` and `/openapi.json` for complete examples, errors, specialized endpoints, CORS behavior, validation, and response contracts.