Generate deck image
generate_deck_imageGenerate an image from a prompt and attach it to a deck page. Returns the image URL and a markdown snippet for embedding.
Instructions
Generate an image from a prompt and attach it to a deck page (editor+), ready for a bg:/image: slot. Returns the serve URL + a snippet; reference it by path (don't regenerate on re-render). Read the imagery module first (deck_authoring_guide module="imagery"): most slides need NO image — use it for atmosphere/concept/focal only, reuse ONE background, write rich on-palette prompts, and prefer images raw. May be unavailable (503) if the instance hasn't configured image generation or AI is paused; generation can take from ~20s to a few minutes depending on the model.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | id of the deck page to attach the generated image to | |
| name | No | optional attachment filename (default deck-image-<n>.png) | |
| seed | No | optional seed for reproducibility | |
| size | No | WxH, default 1280x720 (16:9 — the cover/bg/bleed slot aspect) | |
| model | No | optional model override (else the endpoint default) | |
| steps | No | sampling steps; ~10 for hero/cover, ~4 for incidental texture (more ≈ linearly slower). Omit for the model default | |
| prompt | Yes | the image prompt — rich and specific (scene, light, texture, on-variant colours). For FLUX models append 'no text, no letters, no words' or it invents garbled type; OMIT that only when you deliberately want legible in-image text |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| note | Yes | ||
| markdown | Yes |