Veo 3.1

Generate fixed 8-second videos with selectable Quality, Fast, or Lite tiers and 720p, 1080p, or 4K output. Text and frame generation default to Quality at 720p; reference images require Fast or Lite. ### Supported modes | Mode | Required input | Rules | | --- | --- | --- | | Quality | `model`, `prompt` | Set `quality=Quality` and optional `resolution` (`720p`, `1080p`, or `4k`). | | Fast | `model`, `prompt` | Set `quality=Fast` and optional `resolution` (`720p`, `1080p`, or `4k`). | | Lite | `model`, `prompt` | Set `quality=Lite` and optional `resolution` (`720p`, `1080p`, or `4k`). | | First and last frames | `model`, `prompt`, `images` | Provide one first-frame URL or two URLs in first-to-last order. | | Reference images | `model`, `prompt`, `reference_images` | Provide 1–3 URLs, use Fast or Lite, and do not combine with `images`. | **Async flow:** Create the task, save `data.id`, then [poll the Task](/quick-guide#get-task-status) with `GET /v1/tasks/{task_id}`. On `succeeded`, read `data.output.media`. On `failed`, read `data.error_code` and `data.error_message`, then follow the [error and retry policy](/quick-guide#errors-and-retry-policy). **Using a local file?** [upload a local input](/quick-guide#upload-an-input-file) first and pass the returned `data.url`.

身份验证

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

请求头

Idempotency-Keystring可选<=255 characters

请求

This endpoint expects an object.
Veo31TextOrFrameVideoRequestobject必需

Veo 3.1 text or first/last-frame generation. Output is fixed at 8 seconds and defaults to Quality at 720p. Price depends on quality and resolution.

OR
Veo31ReferenceVideoRequestobject必需

Veo 3.1 reference-image generation. Output is fixed at 8 seconds and supports the Fast or Lite tier, defaulting to Fast at 720p. Price depends on quality and resolution.

响应

Video generation task accepted

错误

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
409
Conflict Error
429
Too Many Requests Error