Veo 3.1 API ： 用文字或图片生成带声音的 AI 视频

Veo 3.1 API 让你的应用通过 HTTP 调用 Veo 3.1 模型，生成带声音的视频。在 NanoAPI 上调用 POST /v1/tasks，传 model veo-3.1、一个版本（standard、fast 或 lite）和两种模式之一（text_to_video 或 image_to_video），再通过回调或轮询拿到生成好的视频。

按你要的出片秒数计费：duration × 所选版本和分辨率的每秒单价。fast 比 standard 便宜，lite 最便宜。两种模式同价，带不带声音也同价。实时价格见上面的表格、价格页和 GET /v1/products，工作台在生成前也会显示准确的费用。生成失败不收费。

standard 画质最好，fast 更便宜，lite 最便宜。standard 和 fast 支持 720p、1080p、4K，总是带声音，还会把提示词扩写成详细的分镜描述；lite 只有 720p，按原文生成，也只有 lite 能加尾帧、用 aspect_ratio auto 跟随首帧的比例、关掉声音。

可以。登录后直接用本页顶部的工作台：它和 API 用的是同一个 Veo 3.1 模型、同样的价格和同一份余额，写代码之前就能确认效果和费用。$10 起充。

duration 可选 4、6 或 8 秒（lite 带尾帧时必须是 8 秒）。standard 和 fast 支持 720p、1080p、4K，lite 是 720p。aspect_ratio 可选 16:9 或 9:16；图生视频建议和首帧的方向一致（横图 16:9、竖图 9:16），用 lite 时也可以传 auto 跟随首帧。variant、mode、prompt、resolution、aspect_ratio 和 duration 每次请求都要传。

有。standard 和 fast 总是带声音，也不接受 generate_audio 参数；lite 不传 generate_audio 时也带声音，设成 false 就是无声视频。带不带声音价格都一样。带声音的成片在 outputs[].url，preview_url 是无声的压缩版。

大多数视频 1–2 分钟出片。生产环境建议传 webhook_url，任务结束时会通知你一次，不用一直轮询。生成的视频保存 15 天，需要的请及时转存。

这个任务冻结的费用会全额退回余额，任务的 error.type 会说明原因，例如首帧图片下载不了。不符合所选版本规则的请求，比如 lite 选了 1080p、standard 传了尾帧，会直接返回 400，不创建任务，也不会冻结费用。