--- slug: "dlazy-picture-book-x-3" source_type: "clawhub" source_url: "https://clawhub.ai/skills/dlazy-picture-book" repo: "" source_file: "description" --- --- name: dlazy-picture-book version: 1.3.5 description: "picture book, storybook, children's book, illustrated story, bedtime story book, η»˜ζœ¬β€”β€”create a complete picture book from a theme: write the paged story, generate style-consistent illustrations page by page with dlazy gpt-image-2, generate matching background music with dlazy elevenlabs-music, then assemble a self-contained HTML book with image-left / text-right spreads, page turning, and background music. Defaults to 10 pages. Use when the user wants a picture book / storybook / children's book / bedtime story, or says 'make me a picture book about ...'." metadata: { 'clawdbot': { 'emoji': 'πŸ“–', 'requires': { 'bins': ['npm', 'npx', 'python3', 'curl'] }, 'install': 'npm install -g @dlazy/cli@1.2.3', 'installAlternative': 'npx @dlazy/cli@1.2.3', 'homepage': 'https://github.com/dlazyai/cli', 'source': 'https://github.com/dlazyai/cli', 'author': 'dlazyai', 'license': 'see-repo', 'npm': 'https://www.npmjs.com/package/@dlazy/cli', 'configLocation': '~/.dlazy/config.json', 'apiEndpoints': ['api.dlazy.com', 'files.dlazy.com'], }, 'openclaw': { 'systemPrompt': "When making a picture book, follow this skill's workflow strictly: first confirm the theme and paged story, then generate illustrations page by page with dlazy gpt-image-2 (the first page establishes the character and art style; later pages pass the first page as a reference image via --images to stay consistent), generate background music with dlazy elevenlabs-music, and finally assemble book.json into index.html with this skill's scripts/build_book.py. Note: Windows PowerShell forbids `&` / `&&` to chain commands β€” run them one at a time; never batch-generate all images at once.", }, } --- # dlazy-picture-book [English](./SKILL.md) Β· [δΈ­ζ–‡](./SKILL-cn.md) picture book, storybook, children's book, illustrated story, bedtime story book, η»˜ζœ¬β€”β€”create a complete picture book from a theme: write the paged story, generate style-consistent illustrations page by page with dlazy gpt-image-2, generate matching background music with dlazy elevenlabs-music, then assemble a **self-contained HTML book with image-left / text-right spreads, page turning, and background music**. Defaults to 10 pages. ## Trigger Keywords - picture book / storybook - children's book / illustrated story - bedtime story / story book - 绘本 / ε›Ύη”»δΉ¦ - make me a picture book about ... ## Authentication All dlazy requests require a dLazy API key. The recommended way to authenticate is: ```bash dlazy login ``` This runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config β€” no manual copy/paste required. ### Alternative: Set the Key Manually ```bash dlazy auth set YOUR_API_KEY ``` The CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\.dlazy\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable. ### Getting Your API Key Manually 1. Sign in or create an account at [dlazy.com](https://dlazy.com) 2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 3. Copy the key shown in the API Key section Each key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard. ## About & Provenance - **CLI source code**: [github.com/dlazyai/cli](https://github.com/dlazyai/cli) - **Maintainer**: dlazyai - **npm package**: `@dlazy/cli` - **Homepage**: [dlazy.com](https://dlazy.com) Run on demand without a global install: ```bash npx @dlazy/cli@1.2.3 ``` Review the GitHub source before installing. ## How It Works Illustrations are generated by `dlazy gpt-image-2` and background music by `dlazy elevenlabs-music`; both are thin clients over the dLazy hosted API: - Prompts and parameters are sent to the dLazy API (`api.dlazy.com`) for inference. - Local reference images are uploaded to dLazy media storage (`files.dlazy.com`); result URLs are also hosted there. The **story text, page composition, and HTML assembly** happen locally β€” you (the agent) write the story and call this skill's `scripts/build_book.py` to inject the content into `assets/template.html`, producing a self-contained HTML. Standard SaaS pattern; the skill does not access network or filesystem beyond what the dLazy CLI handles. --- ## What the output looks like A folder you can open directly; `index.html` is the book: ``` / β”œβ”€β”€ index.html ← the finished book (image-left/text-right, page turning, BGM) β”œβ”€β”€ book.json ← content data (title, per-page image+text, music) β”œβ”€β”€ images/ ← cover.png, page-01.png … page-10.png └── music/ ← bgm.mp3 ``` Reading experience: **cover** (large image + title + "Start reading") β†’ **spreads** (illustration on the left in 3:4, story text on the right; turn pages with arrow keys / click left-right / bottom dots) β†’ **end page**. A background-music toggle sits top-right. On mobile it becomes image-top / text-bottom. Images and music are referenced by **relative paths**, so the whole folder is portable and works offline. --- ## Workflow A picture book is story + image + sound as one whole; quality comes from keeping the three coordinated. Do the steps in order β€” each sets up the next. ### Step 0: Confirm the brief Before starting, align on these (fill sensible defaults for anything unstated and say so β€” don't interrogate the user): - **Theme / core**: what's the story, what does it convey (courage, sharing, friendship…)? - **Page count**: defaults to **10**; the user may specify otherwise. - **Audience age**: defaults to 3–6. Drives text difficulty and sentence length. - **Art style**: defaults to warm, healing watercolor children's-book style. Could also be flat illustration, crayon, Pixar-style 3D, etc. - **Protagonist**: give it a concrete look (e.g. "a little fox in a red scarf") β€” it must stay consistent on every page. ### Step 1: Write the paged story into book.json Write the **whole book's text first**, then generate images, so the visuals follow one narrative thread. - A full arc: **opening (introduce hero + world) β†’ setting out / a wish β†’ a problem β†’ a turn β†’ a warm ending.** Spread this across the 10 pages. - **1–3 sentences per page**, spoken and vivid, good to read aloud. Shorter for younger readers. - Also note a **visual description** for each page (what to draw) β€” you'll need it next. Write `book.json` first (image/music paths as placeholders that will already be correct once generated): ```json { "title": "The Little Fox's Star Lantern", "subtitle": "A warm story about sharing", "cover_image": "images/cover.png", "music": "music/bgm.mp3", "pages": [ { "image": "images/page-01.png", "text": "Deep in the forest lived a little fox in a red scarf…" }, { "image": "images/page-02.png", "text": "…" } ] } ``` ### Step 2: Generate illustrations page by page (keep character + style consistent) Consistency is where picture books fail β€” the same fox can't look different on every page. Use the **first page as a style anchor**: 1. **Generate page 1 first**, writing the character look, art style, palette, and composition in full detail. This sets the visual baseline for the whole book. ```bash dlazy gpt-image-2 --quality low --size 1024x1536 \ --prompt "Children's book illustration, warm watercolor style, 3:4 portrait. An orange little fox in a red scarf lies on a windowsill gazing at the round moon outside, nighttime, soft warm lamplight, healing childlike mood, clean negative space." ``` 2. **Pass page 1 as the reference image** via `--images` on every later page so the hero and style carry over; only the scene changes: ```bash dlazy gpt-image-2 --quality low --size 1024x1536 \ --images images/page-01.png \ --prompt "Same orange fox in a red scarf, same watercolor style and palette. This page: the fox shoulders a small backpack and walks into the forest under the moonlight. 3:4 portrait." ``` 3. The result URL is at `result.outputs[0].url`. **Download it into `images/` with curl:** ```bash curl -L -o images/page-01.png "" ``` On parameters: `--quality low` is low quality (fast, cheap, plenty for small book art); `--size 1024x1536` is the closest small portrait to 3:4 (gpt-image-2 has no exact 3:4 tier; the template crops to 3:4 so it looks right). **Cover**: same idea β€” use page 1 as reference to generate a more atmospheric hero image into `images/cover.png`. > **Execution discipline (important)**: run one generation command at a time β€” wait for it to return and download before the next β€” don't fire all 10 image commands at once or chain them with `&`/`&&`. This is both because later pages need the previous image as a reference and because `&`/`&&` error out under Windows PowerShell. ### Step 3: Generate background music Write one music prompt from the story's mood; give it enough length to cover a read-through (60–90s for a bedtime story is fine, it loops): ```bash dlazy elevenlabs-music --duration 75 \ --prompt "Gentle, soothing children's bedtime music, soft piano and music box, dreamy and warm, a background for reading a picture book aloud, no vocals." ``` Download the result into `music/bgm.mp3` with `curl` the same way. ### Step 4: Assemble the HTML Make sure the paths in `book.json` match the files you actually downloaded, then run this skill's build script: ```bash python3 /scripts/build_book.py book.json -o index.html ``` It injects `book.json` into `assets/template.html` to produce a self-contained `index.html`. Keep `index.html` next to `images/` and `music/`. ### Step 5: Deliver Tell the user the output folder path, that double-clicking `index.html` opens the book, and that the top-right button toggles the music. Share the cover image URL for a quick preview. --- ## Command cheatsheet **Illustration Β· gpt-image-2** (full help: `dlazy gpt-image-2 -h`) | Flag | Picture-book usage | | --- | --- | | `--prompt` | Scene description (character + scene + style + "3:4 portrait") | | `--images` | Reference image (page-1 path) to keep character/style consistent, up to 5 | | `--quality` | `low` (small book art, fast and cheap) | | `--size` | `1024x1536` (closest small portrait to 3:4) | **Background music Β· elevenlabs-music** (full help: `dlazy elevenlabs-music -h`) | Flag | Picture-book usage | | --- | --- | | `--prompt` | Mood description (instruments, emotion, "no vocals", good for reading aloud) | | `--duration` | Seconds; 60–90 is fine for a bedtime story, it loops | Results are always at `result.outputs[0].url`; download with `curl -L -o ""`. ## Error Handling | Code | Error Type | Example Message | | ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | 401 | Unauthorized (No API Key) | `ok: false, code: "unauthorized", message: "API key is missing or invalid"` | | 501 | Missing required parameter | `error: required option '--prompt ' not specified` | | 502 | Local file read error | `Error: Image file not found: C:\path\to\your\file` | | 503 | API request failed (no balance) | `ok: false, code: "insufficient_balance"` | | 503 | API request failed (server error) | `HTTP status code error (500 server crash)` | | 504 | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, e.g. "Prompt violates safety policy"}` | > **AGENT CRITICAL INSTRUCTION**: > > 1. If the result returns `code: "insufficient_balance"`, you MUST explicitly tell the user their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits) > 2. If the result returns `code: "unauthorized"` or indicates a missing API key, you MUST tell the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it with `dlazy auth set `, then resume. > 3. If one image is rejected for violating the safety policy, rewrite that page's prompt (drop sensitive/violent/photoreal-person content) and retry β€” don't abandon the whole book. ## Tips Visit https://dlazy.com for more information.