Google Veo
通过统一视频接口调用 Google Veo 模型(仅文生视频)。成片在查询结果中以 Base64 Data URI 返回。
| 项 | 值 |
|---|---|
| 提交 | POST /v1/video/generations |
| 查询 | GET /v1/video/generations/{task_id} |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
| Content-Type | application/json |
异步流程、轮询与计费见 概述与通用流程。
支持的模型
可用模型以 模型列表 返回为准(或控制台模型价格页)。
文生视频
BASH
curl https://www.nextai-code.com/v1/video/generations \
-H "Authorization: Bearer $NEXTAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"prompt": "A drone shot flying over a misty pine forest at sunrise"
}'
提交响应只有 task_id:
JSON
{ "task_id": "cHJvamVjdHMveHh4L2xvY2F0aW9ucy91cy1jZW50cmFsMS9..." }
任务 ID 按 概述 · 读取任务 ID 的方法读取(先 id 后 task_id),与其它厂商写法一致。Veo 的任务 ID 较长,请完整保存。
图生视频
暂不支持。image、images 不会生效,传了也按文生视频生成。
查询
BASH
curl https://www.nextai-code.com/v1/video/generations/TASK_ID \
-H "Authorization: Bearer $NEXTAI_API_KEY"
Veo 的查询响应结构与其它厂商不同:
JSON
{
"code": "success",
"message": "",
"data": {
"task_id": "cHJvamVjdHMveHh4...",
"status": "succeeded",
"url": "data:video/mp4;base64,AAAAIGZ0eXBpc29t...",
"format": "mp4",
"metadata": null,
"error": null
}
}
| 字段 | 说明 |
|---|---|
status |
queued / processing / succeeded / failed(小写) |
url |
成功时为视频的 Data URI(data:video/mp4;base64,...),取逗号后的部分 Base64 解码即为 MP4 文件;失败时可能为失败原因 |
format |
视频格式,通常为 mp4 |
注意:
- 成功响应包含整段视频的 Base64,体积较大,查询超时请设长一些(如 120 秒)。
- 少数情况下查询会返回 概述 · 查询响应 中的统一格式(
status为SUCCESS/FAILURE等大写值,成片在fail_reason)。请同时兼容两种结构,概述 · 轮询示例 已处理好,可直接照抄。 GET /v1/videos/{task_id}对 Veo 任务返回同样的结构,不是 OpenAI Video 对象。
只需保存成片时(Python):
PYTHON
import base64, os, requests
task_id = "TASK_ID"
r = requests.get(
f"https://www.nextai-code.com/v1/video/generations/{task_id}",
headers={"Authorization": f"Bearer {os.environ['NEXTAI_API_KEY']}"},
timeout=120,
).json()
data = r["data"]
status = data["status"].upper()
video = data.get("url") or data.get("fail_reason") or ""
if status in ("SUCCEEDED", "SUCCESS") and video.startswith("data:"):
with open("output.mp4", "wb") as f:
f.write(base64.b64decode(video.split(",", 1)[1]))
特有参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 是 | 模型名 |
prompt |
string | 是 | 视频描述 |
metadata.sampleCount |
integer | 否 | 生成数量,默认 1。查询只返回第一条视频,建议保持默认 |
限制
- 只支持上表参数。
size、duration及其它metadata字段不会生效,分辨率、时长、宽高比使用模型默认值。 - 生成失败时任务状态为
failed,原因来自模型服务商。
| HTTP | code |
说明 |
|---|---|---|
| 500 | invalid_response |
模型服务商未返回任务 ID,可稍后重试 |
其它错误见 概述 · 错误。