视频生成系列
Veo 3.1 Quality (官方直连)
Google Veo 3.1 Quality 官方直连渠道,直连 Google 官方 API,稳定性优先,支持 720p/1080p/4k,文生视频与图生视频。
CokeAPI 提供 Google Veo 3.1 Quality 的官方直连渠道:请求直连 Google 官方 API,不经第三方中转,稳定性优先。接口行为与 veo3.1-quality 完全一致,仅计费和链路不同。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 succeeded。
图生视频提示:生成接口不再接收内联 base64 图片数据。请先使用 文件上传接口 上传参考图片获取 URL,再传入 image_urls。
模型 ID: Veo3.1-quality-official
调用示例
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | Veo3.1-quality-official | 模型 ID |
| prompt | string | 是 | — | 视频描述文本 |
| duration | int | 否 | 8 | 时长秒数: 固定 8 |
| aspect_ratio | string | 否 | 16:9 | 16:9 / 9:16 |
| image_urls | string[] | 否 | — | 参考图片 URL 列表,用于图生视频(首帧驱动) |
| metadata | object | 否 | — | 扩展参数,见下方说明 |
metadata 字段
| 参数 | 类型 | 说明 |
|---|---|---|
| metadata.generation_type | string | 生成类型: frame(首尾帧插值) / reference(参考图生视频)。不传时根据图片数量自动判断 |
| metadata.resolution | string | 视频分辨率: 720p(默认) / 1080p / 4k |
| metadata.enable_gif | bool | 启用 GIF 输出,默认 false。与 1080p/4k 不能同时使用 |
响应
创建任务 (POST)
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"status": "queued",
"progress": 0,
"model": "Veo3.1-quality-official",
"kind": "video",
"mode": "text_to_video",
"created": 1768380224
}查询任务 (GET /v1/generations/{task_id})
完成后:
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"status": "succeeded",
"progress": 100,
"model": "Veo3.1-quality-official",
"kind": "video",
"mode": "text_to_video",
"result": {
"id": "video_abc123def456",
"object": "video.generation",
"created": 1768380224,
"model": "Veo3.1-quality-official",
"data": [
{
"url": "https://cdn.cokeapi.com/v/video_abc123def456.mp4",
"duration_ms": 8000,
"width": 1920,
"height": 1080
}
]
},
"created": 1768380224
}任务状态说明
| 状态 | 说明 |
|---|---|
| queued | 任务已排队等待处理 |
| running | 任务正在处理中 |
| succeeded | 任务已完成 |
| failed | 任务失败 |
| refunded | 任务失败已退款 |
计费
按 6 秒基准档计费,超过 6 秒按 10 秒档计费(费用 = 基准价 × 10/6)。
| 分辨率 | 6 秒基准价 | 10 秒价 |
|---|---|---|
| 720p | $0.512 | $0.853 |
| 1080p | $0.512 | $0.853 |
| 4k | $0.768 | $1.28 |
失败任务不计费,自动退款。价格为 2026-07 快照,以 模型列表页 实时价目为准。
注意事项
- 官方直连渠道:请求直连 Google 官方 API,不经第三方中转,适合对稳定性和延迟敏感的场景
- 时长固定为 8 秒
- 图生视频请先上传参考图 URL,再通过
image_urls传入 - GIF 输出不能与 1080p/4k 分辨率同时使用
- 失败的任务不计费,会自动返还预扣点数