---
title: "Generate Video Batch"
method: POST
path: "/v1/videos/generate/batch"
tags: ["videos"]
---

# Generate Video Batch

`POST /v1/videos/generate/batch`

## Request

- Base URL: `https://api.corent.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corent.tech/v1/videos/generate/batch`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, nullable

## Request body

- VideoBatchRequest
  - `items` VideoBatchItem[], required
    - `prompt` string, required
    - `style` string, nullable
    - `tier` string, nullable: Quality tier (preferred): air | lite | premium | pro | max_pro.
    - `preference` string: LEGACY alias, still honored: fast | cheap | quality | balanced. Ignored when tier is set.
    - `aspect_ratio` string, nullable
    - `duration_s` integer, nullable
    - `resolution` string, nullable
    - `image_url` string, nullable
    - `end_image_url` string, nullable
    - `reference_image_urls` string[], nullable
    - `reference_video_urls` string[], nullable
    - `reference_audio_urls` string[], nullable
    - `task` 'auto' | 'reference' | 'edit' | 'extend', nullable
    - `return_last_frame` boolean
    - `output_format` 'mp4' | 'mov', nullable
    - `customer_id` string, nullable: Optional tag for YOUR end user, so you can attribute spend: 1 to 128 characters from A-Z a-z 0-9 . _ : @ -. Stored on the job, returned on receipts, and filterable with GET /v1/account/usage?customer_id=...
  - `webhook_url` string, nullable
  - `webhook_secret` string, nullable
  - `customer_id` string, nullable: Optional tag for YOUR end user, so you can attribute spend: 1 to 128 characters from A-Z a-z 0-9 . _ : @ -. Stored on the job, returned on receipts, and filterable with GET /v1/account/usage?customer_id=...

## Response `202`

Successful Response

- BatchAcceptedResponse
  - `batch_id` string, required
  - `job_ids` string[], required

## Other responses

- `400`: Invalid request (bad parameters or input).
- `401`: Missing or invalid API key.
- `402`: Insufficient prepaid balance.
- `403`: API key lacks the required capability scope.
- `422`: Prompt not allowed, or request failed validation.
- `429`: Rate limit, concurrency, or daily spend cap reached.
- `502`: Every eligible provider failed; try again.
- `503`: No provider currently available for this request.

---

[API](https://skmtc.dev/corent/apis/corent-api.md) · [All operations](https://skmtc.dev/corent/apis/corent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corent/apis/corent-api/revisions/57168ff53efe?raw)