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,可稍后重试

其它错误见 概述 · 错误。

相关文档