ナビゲーションにスキップ
BeatAPIVeo 3 1Video API

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

ModeRequired inputRules
Qualitymodel, promptSet quality=Quality and optional resolution (720p, 1080p, or 4k).
Fastmodel, promptSet quality=Fast and optional resolution (720p, 1080p, or 4k).
Litemodel, promptSet quality=Lite and optional resolution (720p, 1080p, or 4k).
First and last framesmodel, prompt, imagesProvide one first-frame URL or two URLs in first-to-last order.
Reference imagesmodel, prompt, reference_imagesProvide 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 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.

Using a local file? upload a local input 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
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error