Batch Paid plans

Batch is a paid-plan endpoint. Free credits (up to 200) cover one video, so there is nothing to batch on a free account. A free-tier key gets 403 upgrade_required with a pricing_url, and nothing is charged. Add credits to unlock it. On a free key, submit jobs one at a time with /generate/video and /generate/image instead.

POST /v1/batch submits up to 10 jobs in one request. Items are the same payloads as /generate/video and /generate/image plus a type discriminator:

bash

curl -X POST "https://api.aiveed.io/v1/batch" \
  -H "X-API-Key: $AIVEED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-assets-001" \
  -d '{
    "jobs": [
      { "type": "image", "model": "nano-banana-pro", "prompt": "Hero shot of a ceramic mug, studio lighting" },
      { "type": "video", "model": "seedance-v1-pro", "prompt": "Steam rising from a ceramic mug, macro",
        "resolution": "480p", "duration": "5" }
    ]
  }'

Semantics

Items are priced and charged individually, submitted sequentially in order.
The batch stops at the first insufficient-credits failure: that item reports the 402 in its per-item result; later items are skipped and never charged.
Other per-item errors (e.g. a 422 unsupported option) do not stop the batch.
The response reports estimated_credits, credits_charged, remaining_credits, and a per-item results array (submitted / error / skipped).
With an Idempotency-Key, retrying the same batch replays the original per-item results — nothing is re-submitted or re-charged.