Flow Agent makes several video variations at once: the API way

Yes: in Google Flow you switch on the Agent toggle in the prompt box and ask it for several variations of a video in one request (Flow Help, read 2026-10-02). Sume's API has no agent toggle, so the same outcome takes either several video jobs or one Format bulk run. This page maps the Flow behaviour onto those two Sume paths.

What Flow documents

Flow's help page says you activate the Agent by toggling Agent in the prompt box, and that you can ask it to create multiple variations of a video at once (read 2026-10-02). The page does not state a maximum number of variations or a credit cost for them, so this post does not either.

Path 1: several video jobs

Each variation is one POST /v1/videos call with its own prompt. Sume accepts a valid job even when your workspace is already running its limit: the job waits as queued until a processing slot opens, and a full queue returns 429 queue_full (Generation admission).

Send an Idempotency-Key on each submit so a retry returns the original job instead of a second charge. Take the finished video from the job result, or register a callback_url and let the webhook tell you.

• Free plan: 1 job processing, 5 queued
• Pro: 4 processing, 20 queued
• Startup: 8 processing, 40 queued
• Scale: 20 processing, 100 queued
• The dashboard Concurrency tab is the source of truth for your effective limit

Path 2: a Format bulk run

If every variation follows the same recipe, save it as a Format and queue the items. A bulk request is a server-side queue of ordinary Format runs: up to 100 items with a concurrency window, created with POST /v1/formats/{handle}/{slug}/bulk-runs and read back with GET /v1/format-run-queues/{queue_id} (Bulk runs).

Each item is one full Format run with its own receipt, so one failed variation does not take the others down. There is no public cancel for the whole queue; you cancel a child run.

What differs from Flow

Flow's Agent plans and phrases the variations for you. On Sume you write the variation prompts yourself, or let a Format do it from an instruction per item. If you want a model to draft the prompts first, that is a separate step before you submit jobs.

Cost on Sume is per job at the model's catalog rate, reserved on submit, so a batch of variations is the per-clip price times the count. Read the per-model price from GET /v1/videos/models before you queue a large set.