返回指南
视频·2026年7月2日·更新于 2026年10月9日·阅读约 7 分钟

Veo 3.1 API——Google 支持原生音频的文本生成视频,兼容 OpenAI(2026)

Veo 3.1 是 Google 支持原生音频的文本生成视频模型。下面介绍如何在 Kunavo 上调用 Veo 3.1 API——三个层级、图像生成视频、约比 Google 官方列表低 50–70% 的单视频价格,以及异步工作流。

最后审核于 。

Veo 3 是 Google 的文本转视频模型,Veo 3 API 可根据文本提示词或静态图片生成电影感视频片段,并带有原生同步音频。Kunavo 通过 OpenAI 风格的视频端点提供整个系列(veo-3-lite、veo-3 Fast 和 veo-3-quality),价格约比 Google 列表价格低 50–70%,使用一个 bearer token 即可。

调用 Veo 3 API

在 /app/keys 生成密钥,然后向 /v1/video/generations 发送 POST 请求。生成需要几分钟,因此同步调用会保持连接,直到视频片段准备就绪:

veo3.py
import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                 # Fast tier; also veo-3-lite / veo-3-quality
        "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
    },
    timeout=600,  # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])

使用 curl 的同一调用:

veo3.sh
curl https://api.kunavo.com/v1/video/generations \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "veo-3",
    "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

如果你的其余代码库已经使用 OpenAI SDK 运行,也可以为所有功能保留一个客户端——聊天、图像和视频共享同一个密钥以及 base_url:

veo3_openai_sdk.py
# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.post(
    "/video/generations",
    body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
    cast_to=object,
    options={"timeout": 600.0},
)
print(resp["data"][0]["url"])

duration(秒)用于在按秒计费的模型(Seedance 系列模型和 Wan 2.7)上设置片段时长。Veo 模型会忽略它;每个 Veo 片段都是 8 秒,按视频计费。

返回的 URL 永久有效。完整参数(resolution、aspect_ratio、image_urls、image_mode)见视频 API 参考。

在 Kunavo 上,Veo 没有种子参数,也没有负面提示词参数。如果请求中包含其中任何一个,该参数会被忽略。

档位与价格

Veo 3 有三个质量档位。下面的单视频费率针对 8 秒 720p 视频片段;1080p 和 4K 价格更高。实时费率见各模型页面。

模型Kunavo(720p / 8 秒)Google 公开价格适用场景
veo-3-lite$0.18+$0.45分镜、预览、高用量
veo-3(Fast)$0.36+$1.20默认档位——电影感 + 原生音频
veo-3-quality$1.60+$3.20主镜头,最佳保真度

图像生成视频

传入 image_url 可让静态图片动起来,适合保持产品或角色的一致性。传入首帧和末帧,可实现受控过渡。

image_to_video.py
# Image-to-video: animate a still by passing image_url
requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "slow parallax, gentle wind through the grass",
        "image_url": "https://your-cdn.com/keyframe.png",
    },
    timeout=600,
)

在生产环境中使用异步调用

不要在高规模场景下保持数分钟的连接。向 /v1/videos 提交任务,获取任务 ID,然后轮询 GET /v1/videos/{id} 直到完成——支持幂等键和可选 Webhook。完整流程见视频文档。

为 Veo 3 编写提示词

  • 描述镜头,而不只是主体——镜头运动(推轨、摇摄、推近)、镜头感觉、光线和节奏最重要。
  • 充分利用音频——Veo 3 会渲染声音,因此请说明你想要的环境声或音效。
  • 明确设置宽高比——横屏使用 16:9,竖屏/社交媒体使用 9:16。
  • 每个 Veo 片段都是 8 秒——请按这个时长设计每个镜头;更长的序列可以拼接多个生成结果。

Kunavo 与直接调用 Google 的比较

Veo 3 也可以通过 Gemini API 和 Vertex AI 以第一方方式使用。如果需要 Google 自有的 SLA 和支持合同,这条路线更合适。以下是实际取舍:

Kunavo直接使用 Google(Gemini API / Vertex)
设置一个密钥,一个 base_urlGoogle Cloud 项目 + 计费账户 + IAM
每个 8 秒 720p 视频片段的价格$0.36+(Fast 档位)$1.20 列表价格
计费预付钱包,所有模型共用一个余额GCP 计费,按服务分项
同一密钥上的其他模型Claude、GPT、图像和音乐模型仅限 Google 模型
容量共享——没有专属配额,上游繁忙时这里也会受到影响你自己的项目配额,可通过支持服务提高
支持 / SLA电子邮件支持,无合同 SLAGoogle Cloud 支持计划

简而言之:Kunavo 在设置时间、单价以及用一个密钥覆盖所有模态方面更有优势。当你需要配额保证或企业协议时,直接使用 Google 更有优势。

Veo 3 与 Sora、Kling 的比较

Veo 3 是目前普遍可用的最强文本转视频模型,也是 Kunavo 上线的模型。Sora 和 Kling 已列入路线图,将通过同一端点提供——有关模型全貌,请参阅文本转视频 API 指南,有关这两个系列,请参阅 Sora API 和 Kling API 指南。

如果你想根据价格而不是这个系列本身来选择视频模型,视频生成 API 对比会以相同的 8 秒 720p 视频片段为标准比较全部八个模型。

常见问题

什么是 Veo 3 API?

Veo 3 是 Google 的文本转视频模型,Veo 3 API 可根据文本提示词或静态图片生成带有原生同步音频的电影感视频片段。在 Kunavo 上,你可以通过 OpenAI 风格的 /v1/video/generations 端点使用一个 bearer token 调用它,支持三个档位:Veo 3 Lite、Veo 3 Fast 和 Veo 3 Quality。

Veo 3 API 的费用是多少?

在 Kunavo 上,Veo 3 按视频计费,价格约比 Google 官方列表低 50–70%:Veo 3 Lite $0.18+、Veo 3 Fast $0.36+、Veo 3 Quality $1.60+,均针对 8 秒 720p 视频片段。1080p 和 4K 价格更高。生成失败不会收费。

Veo 3 会生成音频吗?

会——Veo 3 会在视频旁生成原生同步音频(环境声、音效和对白),这是它与早期静音文本转视频模型的主要区别。

Veo 3 API 在 Kunavo 上比通过 Google 使用更便宜吗?

按单价来说是的:Veo 3 Fast 档位的 8 秒 720p 视频片段为 $0.36+,而 Google 的列表价格为 $1.20,并且无需设置 Google Cloud 项目或计费账户。代价是使用共享容量,而不是自己的项目配额;支持方式是电子邮件支持,而非合同 SLA——如果需要有保障的配额,请直接联系 Google。

如何获取 Veo 3 API 密钥?

注册后,在 /app/keys 创建密钥,设置 base_url=https://api.kunavo.com/v1——无需 Google Cloud 项目。请参阅快速入门。