Google 顶级视频模型。生成 8 秒 4K 视频，支持 AI 音频生成、首帧/尾帧控制。同一个端点下有七条通道可选：从 $0.07 的 Fast 快速档，到 $0.206 的完整标准 4K 渲染，再到首尾帧过渡专用的低价与官方稳定两条线。全部走「创建任务 + 轮询」的异步接口，只需换一个 model 字段。
| 模型 / model 值 | 时长 | 价格 | 说明 |
|---|---|---|---|
Omni Video V3.1-fast (Start-End, Budget) veo-3.1 | 8秒 | $0.30 | 首尾帧低价通道，720p/1080p/4K |
Omni Video V3.1-Lite (Start-End, Official) omni-video-v3.1-lite | 原生时长 | $0.72-$1.152 | 首尾帧官方稳定通道，720p/1080p，首尾帧均必填 |
VEO 3.1 Fast HD veo-3.1-fast-hd | 8秒 | $0.07 | 720p，快速生成 |
VEO 3.1 Fast Full HD veo-3.1-fast-fhd | 8秒 | $0.07 | 1080p，快速生成 |
VEO 3.1 4K (Standard) veo3.1-4k | 8秒 | $0.206 | 完整标准 4K 渲染，画质最佳 |
VEO 3.1 Components 4K (Alt) veo3.1-components-4k | 8秒 | $0.177 | 4K 首/尾帧组件备用通道（与 veo_3_1-components-4K 同价同能力） |
V3.1 Fast Start-End v3.1-fast-start-end | 8秒 | $0.10 | 首尾帧低价备用通道 |
每条通道自身的分辨率写在说明列里,选型时按这一列看:要 720p 就用 Fast HD,要 1080p 就用 Fast Full HD,要最好的画质就用 VEO 3.1 4K (Standard)。
POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。
# Step 1: Create task (with audio and first frame)
curl -X POST https://apimodels.app/api/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",
"size": "4K",
"generate_audio": true,
"images": ["https://example.com/first-frame.jpg"]
}'
# Step 2: Poll status
curl "https://apimodels.app/api/v1/video/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | veo-3.1 / omni-video-v3.1-lite / veo-3.1-fast-hd / veo-3.1-fast-fhd / veo3.1-4k / veo3.1-components-4k / v3.1-fast-start-end |
| prompt | 是 | string | 视频内容描述文本 |
| duration | 否 | number | 视频时长（秒）。veo-3.1 支持 5 或 8；Fast 系列固定 8 |
| size | 否 | string | "4K"（默认）、"1080P" |
| aspect_ratio | 否 | string | "16:9"（默认）、"9:16"、"1:1" |
| generate_audio | 否 | boolean | 生成 AI 同步音轨。默认 false |
| images | 否 | array | 首帧 [0] 或首尾帧 [0][1] 参考图片 URL |
| callback_url | 否 | string | 任务完成后的回调 URL |
images 数组的位置就是语义:传 1 张图 = 首帧,传 2 张图 = 首帧 + 尾帧。想做「从这一帧走到那一帧」的转场,就把起始画面放 [0]、结束画面放 [1]。
专门做首尾帧过渡有两条线:低价的 veo-3.1($0.30,720p/1080p/4K)和官方稳定的 omni-video-v3.1-lite($0.72-$1.152,720p/1080p)。后者的首帧与尾帧都是必填,不能只给一张。
创建任务返回 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
}
}看走哪条通道,它们都在同一个端点上(apimodels.app):VEO 3.1 Fast HD(720p)和 VEO 3.1 Fast Full HD(1080p)是 8 秒 $0.07,VEO 3.1 Components 4K 是 $0.177,画质最好的 VEO 3.1 4K(Standard)是 $0.206。首尾帧过渡另有两条:v3.1-fast-start-end $0.10,官方稳定的 Omni Video V3.1-Lite $0.72-$1.152。换档只改 model 字段,仅成功扣费。
images 数组的位置就是语义:传 1 张 URL 是首帧,传 2 张就是首帧 [0] + 尾帧 [1],和 prompt 一起 POST 到 /api/v1/video/generations。专门做首尾帧的有两条线:低价的 veo-3.1(720p/1080p/4K),以及官方稳定的 omni-video-v3.1-lite(720p/1080p)—— 后者首帧和尾帧都是必填,只给一张过不了。
可以。创建请求里把 generate_audio 设为 true(默认是 false),VEO 会生成与画面同步的 AI 音轨,自动加上环境音和音乐。它就是 POST /api/v1/video/generations 上的一个布尔参数,不用再发第二次请求,也不用另外调音频模型。
veo-3.1 的 duration 支持 5 秒或 8 秒;Fast 系列固定 8 秒。size 可传 "4K"(默认)或 "1080P",aspect_ratio 可传 "16:9"(默认)、"9:16"、"1:1"。另外每条通道自身也带分辨率:Fast HD 是 720p,Fast Full HD 是 1080p,VEO 3.1 4K(Standard)是完整 4K 渲染,Omni Video V3.1-Lite 走原生时长、输出 720p 或 1080p。
是异步的。带上 Authorization: Bearer 调 POST /api/v1/video/generations,传 model 和 prompt,响应里给 data.taskId、state 为 "pending";之后每 5-10 秒轮询 GET /api/v1/video/generations?task_id=...,state 变成 "completed" 时取 data.resultUrls[0],失败时原因在 data.failMsg。生产环境更省事的做法是传 callback_url,任务进终态时我们主动 POST 通知。结果视频保留 7 天。
跑量和出草稿就用 VEO 3.1 Fast HD(720p)和 Fast Full HD(1080p),8 秒 $0.07,是进 VEO 最便宜的门。要成片质量就用 VEO 3.1 4K(Standard),$0.206,完整标准 4K 渲染、画质最好。VEO 3.1 Components 4K($0.177)是 4K 首/尾帧的备用通道,与 veo_3_1-components-4K 同价同能力。首尾帧过渡如果更看重稳定而不是价格,选官方稳定的 Omni Video V3.1-Lite。