Paste the whole script: create_from_script is the one-shot, not a single clip

Paste the whole script. Get the whole video. Turn a script into a finished video is the one-shot path: create_from_script takes a complete script or story, plans scenes, writes shot prompts, saves a workflow, and starts the render without a co-authoring loop. Using it when you only needed an eight-second plate, or using generate a video from text when you already have a 30-second ad script, is how you either overspend a multi-scene run or undershoot with one clip you then try to prompt into a film.

The tool is create_from_script. Required: script. Optional: title, aspect ratio, scene count, asset ids, auto-run, a schedule, refresh-per-run. Server-side it chains draft → assets → scene direction → save → run (and optionally schedule). No intermediate model turns. That is the point. The story-to-video and AI movie maker tool pages are the form versions of adjacent work; this agent job is the deterministic script dump.

Complete script, or a different door

This is for a script you already wrote. "Here's my full script for a 30-second product ad — turn it into a finished video." "Turn this bedtime story into a video with narration." You are not workshopping shot three. If you want to expand scenes, pick models per shot, and approve a draft before anything generates, that is create a multi-scene AI movie. Interactive co-authoring is the multi-step chain. Dumping a finished script into generate_videos is the other miss: one short clip, no scene plan, no saved recipe.

Output is a saved workflow with a run already in progress, or scheduled if you asked. It is priced like a multi-scene video generation, shown before dispatch. That is a real bill. Do not fire it to "see what a paragraph becomes" if you still intend to rewrite the paragraph.

If the same characters and product have to survive next week, you wanted a reusable recipe anyway. Save and reuse a video workflow is the keep. create_from_script can land you there as a side effect of the one-shot. It is still not the button for a single B-roll plate.

Do not ghost-run a draft

The tool exists so a complete script does not die in a half-started manual chain. Give it the script. Name aspect if you care. Name scene count if you already know it. If you do not have a script, write one — or use the movie path — before you pay for a full render.

FAQ

Can I use create_from_script for a 6-second product orbit?

You can. You will still pay a multi-scene workflow-shaped run. A single orbit off a still is image-to-video. A single prompted plate is generate_videos. Match the job to the length.

What if I want to tweak scene two before anything renders?

Use the multi-scene movie path, which saves a draft you approve. This job is the no-back-and-forth chain for a script that is already done.

Does the one-shot also schedule a series?

Only if you ask. Optional schedule_cron. A one-off finished video does not need a cadence. Scheduling a draft you have not watched is a recurring bill.

Is this the same as save_workflow?

save_workflow stores a recipe you built. create_from_script builds, saves, and runs from a pasted script in one deterministic pass. Related, not interchangeable.