Generate a video from a prompt, animate an existing image asset with referenceAssetId, continue a shot from the frame where the film cuts out of it with startFrame, land on a planned picture with endFrame, or put the people, products and places of up to 5 pictures into a new shot with references (read builtin-generative-video first). The shots of one story are made one after another, each from the frame where the one before it is cut, so the story moves forward. Duration is 4–15 seconds. The video comes with its own sound (generateAudio null or true) unless generateAudio is false. Standard settings: 5 seconds, 16:9, 720p, standard quality, with sound. quality picks how it is made: standard (null) for B-roll and most shots; high for a hero shot, made 5 to 15 seconds long and always with its own sound; highest only when the person asks for the best quality. A video with references is made at high, whatever quality you pick, and one with endFrame at high, or highest when silent. A request a quality cannot make, such as a silent video at high, runs at the next quality up and is charged at it. It answers at once with a Job ID and the media is made in the background: start every generation you need, keep working, then call wait_for_jobs with all their Job IDs to get each Asset ID for patch_film. Uses credits for each second: standard about 14 credits a second at 720p and about 9.5 credits a second at 480p; high about 28 credits a second at 720p and about 24 credits a second at 480p; highest about 110 credits a second at 720p and about 51 credits a second at 480p. So a 5-second 720p video uses 72 credits at standard, 143 at high and 552 at highest. Tell the person this estimate for the quality and length you picked before you generate. A credit refusal says what the video needs and how many credits are left: retry only with a duration, resolution or quality that fits, and never substitute another media kind.