Authorization: Bearer YOUR_API_KEY

POST /v1/videos

{
  "id": "video_task_01KQEXAMPLE_VEO31",
  "object": "video",
  "model": "veo-3.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、duration、aspect_ratio、resolution 或 reference_mode 是否符合当前模型要求"
  }
}

GET /v1/videos/{task_id}

{
  "id": "video_task_01KQEXAMPLE_VEO31",
  "object": "video",
  "model": "veo-3.1",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "duration": 6,
    "width": 1920,
    "height": 1080
  },
  "url": "https://example.com/result/veo31-video.mp4"
}

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1",
    "prompt": "生成一段雨夜街景镜头，霓虹反射在路面，镜头缓慢向前推进",
    "duration": 8,
    "aspect_ratio": "9:16",
    "resolution": "1080p",
    "reference_mode": "full_reference"
  }'

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1",
    "prompt": "保留参考图中的主体和整体光影氛围，生成一段镜头缓慢推进的短视频",
    "n": 1,
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg"
    ],
    "duration": 6,
    "reference_mode": "full_reference"
  }'

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1",
    "prompt": "让首帧中的角色向前走近，并自然过渡到尾帧的光线氛围",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "duration": 6,
    "reference_mode": "frame_pair"
  }'