REST API

List all characters

Returns all characters belonging to the authenticated user, ordered by creation date (newest first).

Get character details

Returns a character's details including all reference images.

Create a new character

Create a character with a name, description, and optional source image. If an image is provided, it will be analyzed for multiple people (returns a warning if detected).

Delete a character

Permanently deletes a character and all its data (reference images, generated images, storage files).

List brand kits

Get brand kit with assets

Create a brand kit

Create a new brand kit. Supply name, optional logo, optional palette (JSON array of {name, hex}), and optional brand_voice text. Returns the created brand kit.

Upload a brand asset (logo variant, product, packaging)

Update brand kit metadata

Delete a brand kit

Delete a brand asset

Generate a scene image

Generate a scene image featuring a character. Uses multiple reference images for consistency. Includes automatic retry with consistency checking and scene accuracy validation. Costs 1 credit.

Generate single-attribute variations of an existing scene

Take an existing generated scene as the source and produce N near-clones that differ in ONE specified dimension (expression, outfit, lighting, angle, pose, or background) while preserving everything else. Internally fans out N parallel /api/generate calls anchored on the source image. Costs 1 credit per generated variant (count). Only supported for character-anchored scenes (brand-only generations have no chain anchor).

Generate a multi-character scene

Generate a scene image featuring 2-4 characters together. Includes character count verification and per-character consistency checking. Costs 2 credits.

Generate a storybook

Generate a full storybook with multiple pages. Supports single or multiple characters, optional consistency checking per page, style continuity between pages, and PDF export. Costs 1 credit per page.

List your comics

Returns the caller's comics newest-first, with the page-1 thumbnail attached for list rendering.

Fetch a comic + its pages

Create an empty comic shell

Spec §4 primitive. Creates a comic project with cast + style + optional setting and outfit locks. No panels are generated — call POST /api/comics/{id}/panels to add panels one at a time, or use POST /api/comics/generate for one-shot plan+generate.

Generate one comic panel

Spec §4 primitive. Generates a single panel image using the comic's locked setting + outfit locks + style. The bubble overlay is derived from caption/caption_type/speaker. Costs 1 credit; refunded on failure.

Assemble a comic for compositing

Spec §4 primitive. Returns the comic + its panels (with bubble specs + shot + image URLs) so the caller can composite layout client-side. A future iteration may return a server-rendered PNG/PDF.

One-shot: plan + create + generate a full comic

Convenience macro that wraps the spec-aligned primitives. Plans the setting + outfit locks + N panels (caption, action, shot) from a story idea using Claude, then runs panel generation in the background. Returns immediately with the comic id; the caller polls GET /api/comics/{id} to watch panels fill in. Costs 1 credit per panel; refunded per failed panel.

Delete a comic (cascades to pages)

Browse the character library

Browse pre-built characters available for import. No auth required.

Import a library character

Import a pre-built character from the library into your account. Creates a copy with reference images ready for scene generation.

Get credit balance

Returns the authenticated user's current credit balance and plan.

List your API keys

Returns all API keys for the authenticated user (key values are not returned, only prefixes).

Create a new API key

Generate a new API key. The full key is only returned once — save it immediately. Maximum 5 active keys per user.

Revoke an API key