A multi-scene AI movie plans every scene before it spends
create_ai_movie is a scene list, a draft, then a stitch. One long text-to-video prompt is a different job.
A multi-scene AI movie plans every scene before it spends. Describe the story. Get every scene generated and stitched. create_ai_movie builds a project with a scene-by-scene draft — each scene can be text-to-video, image-to-video, or first-last-frame, each with its own model — and only dispatches after you approve. Treating a movie as one long generate, or as a narrated pipeline you did not ask for, wastes credits on a clip that was never going to hold a story.
Create a multi-scene AI movie is the named capability. The AI movie maker is the studio door. Supporting calls (expand_movie_scene, start_movie_generation, update_ai_movie_scene, get_movie_status, combine_ai_movie) are plumbing. You describe the film. The agent plans, then spends.
What this job actually is
You want a short film or a multi-scene sequence with control per shot. You describe the story. The agent can expand brief scene ideas into cinematic prompts first. It saves a draft you review. Credits are not spent while planning. After you approve, it dispatches every scene, tracks progress, and auto-combines the finished clips.
That is a movie project, not a single catalog row. A 40-second montage with per-scene model variety belongs here. A six-second wheat field does not.
Each scene is priced like its own video generation. The quote you confirm is the sum of those scenes, not a magical bulk discount for saying "movie."
What wastes credits
One prompt, one clip, call it a film. Generate a video from text is a shot. Padding the prompt with "scene two" and "scene three" does not create a project, a draft, or a stitch. You get one take that tried to be three.
A finished script you wanted rendered in one shot. That is turn a script into a finished video (create_from_script). Movie mode is for co-authoring scenes, mixing generation types, and reviewing a draft. Script mode is for a complete document you do not want to scene-edit.
A timeline of files you already have. If the clips exist, you wanted build a video from clips, music, and captions, not a movie generate. Regenerating footage you already shot is how a stitch becomes a second production.
Skipping the draft. The expensive habit is approving a vague three-scene list and discovering scene two needed a reference image you never attached. Plan first. Spend second.
The test
Is the unit a scene list?
If you can name scene one, scene two, and scene three, and you want them generated then combined, this is the job. Stay for the draft.
If the unit is one shot, generate a clip. If the unit is a pasted script with narration, use script-to-video. If the unit is four HTTPS clip URLs, assemble. This is one named agent job. Using it for a different job wastes credits.
FAQ
Do I pay while the agent is still planning scenes?
No. Credits are spent after you approve the draft and generation starts, not while planning. That is the point of the draft. Use it.
Can each scene use a different model?
Yes. Text-to-video, image-to-video, or first-last-frame per scene, with a model per scene. That variety is why this is not one generate.
Is this the same as a background multi-step task?
A movie often runs as a long job, and automating a multi-step content task is how you keep chatting while it renders. The capability that defines the film is still create_ai_movie. Do not spawn a task whose steps are "make a video" three times with no project.
Why not generate three clips and stitch them myself?
You can. You will also be the person who notices they do not cut, that scene two drifted wardrobe, and that nobody combined them. The movie job is the project plus the stitch. DIY is three generate charges plus an editor pass you could have had in the same request.