Skip to Content

VEO3 Video Generation

Asynchronous video generation with task-based result retrieval.

Endpoint

POST https://123api.co/v1/videos/generations

Request Example

curl --request POST \
  --url https://123api.co/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Common Parameters

FieldTypeDescription
modelstringExample: veo3.1-fast
promptstringVideo instruction
durationnumberVideo duration in seconds
aspect_ratiostringExample: 16:9
image_urlsarrayOptional reference image inputs

Typical Response

{
  "task_id": "task-unified-123456",
  "status": "queued",
  "model": "veo3.1-fast"
}

Workflow

  1. Submit the generation request
  2. Store the returned task_id
  3. Poll task status until completion
  4. Persist the final video URL on your own side if needed

Save the returned task ID and poll the status endpoint instead of assuming synchronous completion.