Personalised story API
One API for narrative, illustration and human creative review. Every customer detail shapes the story — and real designers refine it for free until it is ready to sell.
See a live storyFirst 5 books free Unlimited designer refinements ~2 business days
+2
POST /v1/design-requests
{
"child": { "first_name": "Noah" },
"age": 4,
"location": "Boston",
"wish": "go_to_the_moon",
"companion": "Milo",
"images": ["img_01", "img_02"],
"story_style": "moonlit_adventure",
"illustration_style_id": "storybook_soft_01"
}202 Accepted{
"id": "story_82cd10",
"status": "ready",
"assets": {
"cover_url": "https://cdn.storytellrs.ai/s/story_82cd10/cover.jpg",
"pages_url": "https://cdn.storytellrs.ai/s/story_82cd10/pages.json"
}
}Proposed API · fields may change
Two ways to buy
Same creative engine. Choose how you take it to market.
Early access · manual approval · about 5 pilot partners. Endpoints below are for evaluating the integration, not a production multi-client tenant.
Built on MagicLabs production experience
From inputs to a finished story
Send approved customer details and images. Receive narrative, illustrations, layouts and review status as one coherent product — with unlimited refinements by real designers included.
Every detail shapes the plot, tone, story style and images.
A recognisable character across every scene.
Illustration, text and layout created together.
Free API revisions handled by real designers.
Why Storytellrs
Compare the same Noah brief at two levels of execution. Storytellrs brings story direction, art direction, character consistency, designed layouts and human creative review into one production system.
BASELINEIndustry standardSTORYTELLRS SYSTEM✦ Storytellrs finishBeyond generationWhat changes in the finished product
Generic child likenessNoah and Milo feel recognisable throughout
A template plot with inserted detailsStory direction built from the child’s world
Illustration and text assembled separatelyNarrative, art direction and layout designed together
Generation as the finish lineHuman creative review before delivery
How it works
Asynchronous by design. No long-running client requests. Typical first delivery: about 2 business days. Typical revision: same day to 1 business day.
Provide child information, approved images, locale, product format and style. You receive 202 Accepted with a request ID immediately.
{ child: "Noah", style: "soft" }POSTStorytellrs selects the right models and workflows for narrative, character, illustration and layout.
Automated checks and trained specialists review likeness, tone, visual quality and brand rules.
Your webhook receives structured story data and secure delivery URLs — typically within about 2 business days for a new design.
story.ready200 OKBuilt for developers
Early access: we onboard about 5 pilot partners by hand. The endpoints below are listed so you can evaluate the integration — not a production multi-client tenant. Keys after review. No self-serve signup, dashboard, or client isolation.
Quickstart
Authenticate, create a design request, wait for the webhook (or poll status), then request free refinements when needed.
Authorization: Bearer $STORYTELLRS_API_KEY on every request. Keys are issued after manual approval of your access request.
POST /v1/design-requests returns 202 with id and status: "queued". Do not wait on a long HTTP connection.
queued → generating → in_review → ready (or needs_input / failed). Prefer webhooks; poll GET /design-requests/:id as a fallback.
story.ready. Fetch the structured story with GET /stories/:id.
POST /design-requests/:id/revisions sends instructions to real designers. Revisions do not consume your free or paid completed-design allowance.
Idempotency-Key on create and revision to avoid duplicates. Expect 401 auth, 422 validation, 429 rate limit, 409 conflict on stale revisions.
Indicative turnaround during early access: ~2 business days for a new completed design · same day to 1 business day for a revision.
Proposed API · fields may change
Tone ✓Visual craft ✓Brand rules ✓Creative review complete
Approved for deliveryPowered by technology. Crafted by humans.
Our systems automate the heavy lifting. Trained creative specialists review the details that determine whether a story feels polished, coherent and safe to publish.
✦ Our in-house creative team in Bhutan brings human care and judgement to every production workflow.
Children’s data & privacy
When images of children enter the workflow, responsibilities stay clear. You collect consent; we process only what is needed to deliver the story.
You obtain and record parental or guardian consent before uploading child images or personal details. Storytellrs processes data as your production processor for story creation.
Images and payloads are encrypted in transit (TLS) and at rest. Access inside production systems is limited to the people and services required for generation and review.
Production assets are retained for delivery, revision and invoicing support, then deleted on a defined schedule or earlier on partner request for a specific story or account.
Generation models and secure infrastructure providers support orchestration. Human creative review is performed by trained MagicLabs specialists under the same confidentiality controls.
Primary production systems run in the EU (Ireland) with optional US processing for partners who require it. Region selection is confirmed during onboarding.
Customer-uploaded child photos and partner brand assets are not used to train foundation models. They are used only to fulfil design requests and revisions for your account.
Full DPA and security pack available during access review. Privacy FAQ ↓
Your brand, your story world
Start with a direction that fits age, purchase context and format. If your brand needs a new visual language, we scope a custom style with an explicit setup fee.
White-label by design Storytellrs stays behind the scenes. Your customers experience your brand, checkout and relationship from start to finish.
Live US product
The live US product sells personalised storybooks. Template plots with swapped names were not enough to turn previews into purchases.
Families answer a short questionnaire and upload approved images — every detail shapes direction, narration and illustration.
We orchestrate narrative and art, run human review, and refine free via the API until the story is ready to sell.
About 4 in 10 families who start a story request go on to buy the finished book — not a relative lift, an absolute conversion rate.
“Families recognise their child in the finished book — that is what turns a preview into a purchase.”
Storytellrs · live US product
of story requests buy a book
Families start on the live US product.
Design, orchestration and quality review.
A complete story, ready to preview and purchase.
Clear integration boundaries
Launch a new personalised product without rebuilding the production stack behind it.
Pricing
Your first 5 books are free. After that, each completed design is $4. Unlimited refinements by real designers are included on every design. A new direction or new brief starts a new completed design.
Starter
Pay as you go
Volume
Developer experience
A focused quickstart and sample request/response, without exposing the production backend.
FAQ
Still evaluating the fit? Talk to us about your product, volume and brand requirements.
Deeply personalised books and stories from structured customer inputs and approved images, delivered as structured story JSON and production assets. A hosted viewer is available on the white-label path.
Storytellrs combines model orchestration, creative production workflows, consistency checks, brand controls and human review. You receive a finished creative product rather than raw outputs — with unlimited refinements by real designers included.
No. Each approved detail can shape the story direction, tone, writing style, scenes and imagery. Our team applies the narrative and conversion experience learned from producing personalised stories in market, so the result feels intentionally made for the child rather than assembled from interchangeable fields.
Retouches are free and unlimited on an existing design. Request revisions through POST /design-requests/:id/revisions and real designers will refine the story, illustration or layout. A new direction or new brief creates a new completed design.
A completed design is the first approved delivery of a new brief. Example: Noah’s Moon story in Soft Storybook = 1 design. Three free retouches on that story = $0. Restarting the same child in Watercolour Classic (new direction) = +1 design. Your first 5 books free count these completed designs, not revisions.
Two paths: API only (JSON + assets, you keep checkout) or white-label (same engine plus a hosted viewer). A hosted cart is scoped — talk to us if you need it. You keep the customer relationship and brand experience.
Your first 5 completed designs (books) are free. After that, completed designs are billed at $4 each. Revisions never consume the free allowance. During early access, we review usage and send a monthly invoice instead of charging automatically.
Request access with your work email. We reply within 1 business day, review the request by hand, and share credentials after approval. There is no self-serve signup and no instant API key.
Creation is asynchronous. The API returns a request ID immediately and a webhook notifies your system when the story is ready. Indicative early-access turnaround: about 2 business days for a new completed design, and same day to 1 business day for a revision.
Automated checks and trained creative specialists review the areas that most affect quality and brand safety, including likeness, consistency, tone, visual craft and approved brand rules.
Partners obtain parental or guardian consent before upload. We encrypt data in transit and at rest, retain assets only for delivery, revision and billing support, delete on schedule or request, host primarily in the EU (Ireland) with optional US processing, and do not use customer-uploaded child photos to train foundation models. See Children’s data & privacy.
Your customers. Your brand. Our creative engine.
Add personalised books and stories to your product with one API. Request access, we onboard you by hand, then your first 5 books are free — $4 per completed design after that, with unlimited designer refinements included.