如何使用 Veo 3.1 文生视频 API：文生视频接入指南（2026）
Veo 3.1 文生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
Veo 3.1 文生视频 是一款文生视频模型（由 Google 提供）：叙事级文生视频。 支持 1080p 画质，具备角色一致性 (R2V) 保持与人物对白口型同步功能。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $3.20。
TL;DR
· 任务类型：文生视频，由 Google 提供
· 价格：典型一次约 $3.20（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：7 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 Veo 3.1 文生视频 能做什么？
短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。
社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。
已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。
怎么调用这个 API？
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册送免费积分）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/google/veo3.1/text-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Cinematic tracking shot of a futuristic cyberpunk night market in Tokyo, wet pavement reflecting vibrant neon pink and blue lights. A mysterious figure in a trench coat walks away from the camera into the steam rising from food stalls. Atmospheric lighting, photorealistic 8k textures, shallow depth of field. Audio: Heavy rain pouring, distant police sirens wailing, and the sizzling sound of street food cooking.",
"aspect_ratio": "16:9",
"duration": "8",
"resolution": "1080p",
"generate_audio": true,
"negative_prompt": "cartoon, illustration, sketch, blurry, low resolution, distorted audio, silent, shaky camera, overexposed, low quality",
"seed": 0
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数？
prompt（提示词）：必填
aspect_ratio（宽高比）：可选，默认 "16:9"
duration（视频时长）：可选，默认 "8"
resolution（分辨率）：可选，默认 "1080p"
generate_audio（生成音频）：可选，默认 true
negative_prompt（负面提示词）：可选
seed（随机种子）：可选
Veo 3.1 文生视频 的提示词怎么写？
1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按次积分计价，典型一次调用约 $3.20（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
Veo 3.1 文生视频
支持原生音频与角色一致性的电影级 1080P 文生视频模型。
Google Veo 3.1 T2V 是 Google DeepMind 最先进的文生视频模型。它能将文字脚本转化为画质精细的 1080P 视频。其最大的突破在于**“音画同步”（包含对白口型同步）以及“R2V 主体一致性”**，允许用户通过参考图来固定视频中的角色长相，是叙事创作的终极工具。
🚀 核心亮点
- 电影级写实感：生成具有自然光影、准确透视和流畅运镜的视频，质感媲美实拍素材。
- 原生音频与对白：生成与画面完全同步的音频，包括环境音、背景音乐，甚至支持人物对白与口型同步。
- 主体一致性 (R2V)：通过上传 1-3 张参考图 (Reference Images)，让模型在生成视频时保持角色或物体的一致性，避免“换脸”问题。
- 灵活输出格式：支持 1080p/720p 分辨率，完美适配横屏 (16:9) 和竖屏 (9:16) 创作。
- 视频插值：支持在两个指定帧之间生成丝滑的过渡动画，适合制作开头和结尾确定的片段。
🛠️ 技术参数
| 参数 | 说明 |
|---|---|
| 模型版本 | Google Veo 3.1 T2V |
| 输入方式 | 文本提示词 (+ 可选 R2V 参考图) |
| 输出分辨率 | 1080p (全高清) / 720p |
| 视频时长 | 4秒、6秒、8秒 |
| 帧率 | 24 FPS (固定) |
| 生成耗时 | 约 2–3 分钟 (8秒 1080p 模式下) |
关键参数说明：
prompt: 描述画面内容、运镜方式、光影氛围以及声音。references: (可选) 上传 1-3 张图片用于 R2V 功能，保持主体一致。durationSeconds: 选择 4、6 或 8 秒。
💰 定价策略
| 模式 | 单价 (每秒) | 8秒视频预估成本 |
|---|---|---|
| 仅视频 (无声) | $0.20 / 秒 | ~$1.60 |
| 视频 + 音频 | $0.40 / 秒 | ~$3.20 |
FAQ
可以先免费试用吗？+
注册即送积分，但赠送积分目前仅适用于应用内的部分换脸功能；本模型按量积分计费。Playground 仍可无代码试玩，提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
NamiFusion 是无过滤引擎，不做武断限制、对 NSFW 友好，但禁止违法内容与非自愿的真人素材，详见服务条款。
Veo 3.1 文生视频 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。