Generate an AI image story video
generate_image_storyCREATES an AI image story: a narrated script turned into a sequence of AI-generated images, read aloud with captions over it. Suited to facts, history, horror, storytime and explainers. YOU WRITE THE SCRIPT, AND ONLY THE SCRIPT: the text you send is the narration that is spoken, verbatim, in that order (get_recipe image-story has the writing advice and a worked example). Show it to the user as plain text before spending anything and change it until they like it (iterating is free). Never write the pictures: aicut cuts your script into scenes and writes every image prompt itself. PRICE IS DRIVEN BY THE IMAGE COUNT, not the words: estimate_only: true returns scene_count and voice_provider beside the money, so say the count and the price. The levers: seconds_per_image (3 default; 5 is cheaper, 2 dearer), image_model (zit-realism is the default; gpt-image-2.5 has the highest per-image price, so quote it before using it) and voice_provider (the two voice services are priced differently). Re-quote after changing any of them or adding a style_id (list_image_story_styles: it forces the expensive edit-capable image model). AFTER: this one call makes the finished video (the answer carries scene_count, the price split and renders_automatically: true; no fire or render step). Wait with wait_for_generation; when terminal get_video carries the file url. start_confirmed: false means the job exists but its start was never confirmed: do not create it again, watch it, and tell the user it may need a retry if it has not moved in fifteen minutes. LANGUAGE: a script not in language is TRANSLATED, so a quote is exact only for the script you sent. A script over the language's character limit is refused (aicut will NOT cut it); too many images for one video: use a longer seconds_per_image. SPENDS TOKENS: price with estimate_only: true, ask in the SAME message as the price, and wait for a go that names THIS purchase (SPENDING RULES, this server's instructions). IDEMPOTENCY: a reused idempotency_key REPLAYS the first job whatever the settings: never reuse one for a new generation (this server's instructions).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The narration script in plain prose: what the voice says, start to finish. No scene markers, image directions or speaker labels; aicut cuts it into scenes and writes every image itself. | |
| voice | No | The narrator's voice. The voice id, in the provider named by `voice_provider`; omit for that provider's default narrator. openai: alloy, ash, ballad, coral, echo, sage, shimmer, verse (`ash` reads deepest, `shimmer` and `sage` lighter; retired `onyx`, `nova`, `fable` still work, speaking as `ash`, `shimmer`, `alloy`). elevenlabs: an id from `list_voices` with `provider: 'elevenlabs'` (stock, cloned or custom voices; PAGED: pass `limit: 100` and read `has_more` before saying a voice does not exist). Any other id is refused uncharged. Cloned and custom ElevenLabs voices ARE accepted here and on `generate_fake_text_video`; `generate_audio` cannot. | |
| language | No | The language `text` is written in, by name; default English. Naming another language makes aicut translate the script, which changes its length and the price. | |
| style_id | No | An authored look from `list_image_story_styles`. It forces the expensive edit-capable image model, so re-quote. Omit for aicut's default photorealistic look. | |
| image_model | No | The look of the images; default `zit-realism` (photoreal, cheapest). `zit-lora-*` and `zit-comic` are illustrated looks at the same price, `flux-klein*` cost more, `gpt-image-2.5` is the priciest: quote it before you pick it. | |
| aspect_ratio | No | Defaults to `9:16`, the vertical shape every short-form platform wants. | |
| caption_style | No | How the burned-in captions look; default `karaoke`; `none` turns them off. | |
| estimate_only | No | Price only; creates nothing. | |
| sound_effects | No | An ambient sound effect per scene. Defaults to false, and it ADDS to the price by the video's length: quote it. | |
| voice_provider | No | Which voice service reads the narration. `openai` (the default) or `elevenlabs`. The two voice services are priced differently, so call `estimate_only` again after changing it. | |
| idempotency_key | No | Retry-safety key (IDEMPOTENCY). | |
| caption_position | No | Where the captions sit; default `bottom`. | |
| image_resolution | No | Defaults to `standard`. `high` selects the model's high-resolution price row (for some models both rows cost the same). | |
| seconds_per_image | No | How long each image stays on screen; default 3. THE MAIN PRICE LEVER: 5 buys roughly 40% fewer images than 3 for the same script, 2 buys 50% more. | |
| transition_sounds | No | A whoosh between scenes. Defaults to false; free. | |
| transition_effects | No | A visual slide between scenes. Defaults to false; free. |