Features

Storybooks

Generate a sequence of consistent illustrations for a story. Pages chain together so outfit, lighting, and visual register carry across, then optionally export to PDF.

What you get

  • One scene per page, all featuring the same locked character (or a multi-character cast).
  • Optional cross-page chaining via previous_image_id — page N anchors on page N-1, drastically cutting outfit / lighting drift across the book.
  • Optional consistency check + retry per page. Slower but higher quality.
  • Optional PDF export — assembled, paginated, downloadable.

From the UI

  • Open the /library or use the standalone storybook example app at examples/storybook-demo-app.
  • Pick a character, type N page prompts (one per line), choose options, generate.

From the API

bash
curl -X POST https://steadyshot.ai/api/storybook \
  -H "Authorization: Bearer ss_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "character_id": "<luna-id>",
    "pages": [
      "Luna wakes up in a sunlit forest clearing",
      "Luna spots a glowing mushroom and approaches",
      "Luna touches the mushroom — it pulses with light",
      "Luna runs home through the trees, smiling"
    ],
    "art_style": "studio ghibli",
    "consistency_check": true,
    "export_pdf": true
  }'

# Response
{
  "character_ids": ["..."],
  "character_names": ["Luna"],
  "total_pages": 4,
  "generated": 4,
  "failed": 0,
  "pages": [
    { "page": 1, "prompt": "...", "image_url": "...", "consistency_score": 92 },
    ...
  ],
  "pdf_url": "https://...storybook.pdf"
}

Multi-character storybooks

Pass character_ids (array of 2-4) instead of character_id for stories with multiple recurring characters. Costs 2 credits per page (vs 1 for single-character).

From Claude Desktop (MCP)

text
"Generate a 5-page storybook of Luna meeting Milo at the seaside,
art style: watercolor. Export to PDF when done."

Claude calls generate_storybook with the right params. See MCP integration.

For best cross-page coherence keep art_style constant across the book and enable chaining. Storybook endpoint chains by default; the per-page /api/generate path needs previous_image_id threaded manually.