Google VEO 3.1 视频生成 API

可用模型

怎么选:草稿和批量用 veo-3.1-fast-fhd,它和标准档吃同样的提示词和图片;定稿要画质时把 model 换成 veo-3.1。没有任何一档输出 4K。旧的 veo3.1-4k、veo-3.1-components、veo_3_1-4K 等名字仍然可用,都等于 veo-3.1-fast-fhd、按 $0.088 计费。

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。

# Step 1: Create task (standard tier; add "images" for a first frame or first + last frame)
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "Aerial drone shot of a coastal sunset, waves crashing on rocks",
    "aspect_ratio": "16:9",
    "images": ["https://example.com/first-frame.jpg"]
  }'

# Step 2: Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

没有 duration 和 size 参数:每条固定 8 秒,分辨率由模型决定(fast-hd 720p,其余 1080p)。传了也会被忽略。

首帧与尾帧

时长、分辨率与音频

• 每条固定 8 秒,三个模型都一样。
• 分辨率由模型决定:veo-3.1 和 veo-3.1-fast-fhd 出 1080p(1920×1080 或 1080×1920),veo-3.1-fast-hd 出 720p。没有 4K。
• 音轨随画面一起生成,下载到的 MP4 已经带音频,不需要额外参数。
• aspect_ratio 默认 "16:9",另可传 "9:16"。

响应与轮询

创建任务返回 taskId,state 先是 pending:

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending"
  }
}

用 GET /api/v1/video/generations?task_id= 轮询,state 变成 completed 后取 resultUrls[0]:

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "resultUrls": ["https://cdn.example.com/video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

• 失败时 state 为 "failed",原因在 data.failMsg,例如 "Content policy violation"。失败不扣费。
• 建议每 5-10 秒轮询一次;生产环境改用 callback_url 更省事,任务进入终态时我们主动 POST 通知。
• 视频文件保存 30 天后自动删除,请及时下载或转存。

相关