Google 的视频模型,固定 8 秒一条,音轨随画面一起生成,支持首帧或首尾帧参考图。同一个端点下三个模型:标准档 veo-3.1 真 1080p、$1.00 一条(比 Google 官方的 $3.20 低 69%);Fast 档 720p 和 1080p 都是 $0.07。全部走「创建任务 + 轮询」的异步接口,换模型只改 model 字段。
| 模型 / model 值 | 分辨率 | 价格 / 8 秒 | 说明 |
|---|---|---|---|
VEO 3.1 (Standard) veo-3.1 | 1080p | $1.00 | Google 的标准档,站上画质最高的 VEO;细节、运动质感和提示词还原度都优于 Fast。官方 $3.20/条。 |
VEO 3.1 Fast Full HD veo-3.1-fast-fhd | 1080p | $0.07 | 快速档,出草稿和批量首选;首尾帧过渡也走它。v3.1-fast-start-end 是它带备用渠道的别名,$0.10。 |
VEO 3.1 Fast HD veo-3.1-fast-hd | 720p | $0.07 | 快速档 720p,只在 720p 够用、要最快出片时选。 |
怎么选:草稿和批量用 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.07 计费。
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"| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | veo-3.1(标准档)/ veo-3.1-fast-fhd / veo-3.1-fast-hd;v3.1-fast-start-end 是 fast-fhd 的别名 |
| prompt | 是 | string | 视频内容描述文本 |
| aspect_ratio | 否 | string | "16:9"(默认)或 "9:16" |
| images | 否 | array | 参考图 URL:[首帧] 或 [首帧, 尾帧]。不传就是纯文生视频 |
| callback_url | 否 | string | 任务完成后的回调 URL |
没有 duration 和 size 参数:每条固定 8 秒,分辨率由模型决定(fast-hd 720p,其余 1080p)。传了也会被忽略。
images 数组的位置就是语义:传 1 张图 = 首帧,传 2 张图 = 首帧 + 尾帧。想做「从这一帧走到那一帧」的转场,就把起始画面放 [0]、结束画面放 [1]。三个模型都支持,价格不变。
对成功率要求最高的批量首尾帧任务,可以用 v3.1-fast-start-end:它是 veo-3.1-fast-fhd 的别名,$0.10 一条,主渠道失败时自动切到备用渠道再试一次。
创建任务返回 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
}
}同一个端点上三个模型:veo-3.1 是标准档、真 1080p,每条 8 秒 $1.00 —— Google 官方按秒收 $0.40,同一条要 $3.20;veo-3.1-fast-hd(720p)和 veo-3.1-fast-fhd(1080p)都是每条 $0.07。换模型只改 model 字段,只有生成成功才扣费。
images 数组的位置就是语义:一张 URL 是首帧,两张是首帧 [0] 和尾帧 [1],和 prompt 一起 POST 到 /api/v1/video/generations;veo-3.1 和 veo-3.1-fast-fhd 都能按各自的价格生成这 8 秒过渡。v3.1-fast-start-end 是 Fast 1080p 的别名,$0.10,多一条备用渠道兜底,适合对成功率要求最高的批量任务。
会。站上三个 VEO 3.1 模型的音轨都随画面一起生成,下载到的 MP4 已经带音轨,不需要额外参数,也不用再发一次请求。
每条都是 8 秒。分辨率由模型决定 —— veo-3.1-fast-hd 是 720p,veo-3.1-fast-fhd 和 veo-3.1 是 1080p —— 所以没有 size 参数;aspect_ratio 可选 16:9 或 9:16。没有任何一个模型输出 4K:旧的 veo3.1-4k、veo-3.1-components 等名字仍然可用,都等于 veo-3.1-fast-fhd,按 $0.07 计费。
是异步的。带上 Authorization: Bearer key、model 和 prompt 发 POST /api/v1/video/generations,响应里的 data.taskId 对应 state "pending";然后每 5-10 秒 GET /api/v1/video/generations?task_id=... 轮询,state 变成 "completed" 后读 data.resultUrls[0],"failed" 时原因在 data.failMsg。生产环境建议传 callback_url,任务进入终态时我们主动 POST 通知。成片保留 7 天。
草稿用 veo-3.1-fast-fhd:1080p 只要 $0.07、出片快,而且和标准档吃同样的提示词和图片。定稿要细节、运动质感和提示词还原度时换 veo-3.1 —— 它是 Google 的标准档,$1.00 一条,仍比直连官方便宜 69%。只有 720p 够用、想要最快出片时才选 veo-3.1-fast-hd。