Veo 3.1 Lite API

Google 的轻量视频模型,支持文生、首帧图生、横竖屏和可选原生音频。

720p · 无音频
Google $0.03 / 秒
1080p · 无音频
Google $0.05 / 秒
1080p · 含音频
Google $0.08 / 秒
4 秒 · 720p · 含音频
KIE $0.0188 / 秒
官方$0.05省63%

价格比较

同一输出规格,比较各渠道公开价

比较其他模型
输出规格渠道渠道公开价接口耗时试用
720p · 无音频
Google官方
$0.0300 / 秒
试用
NanoAPI
$0.0585 / 秒贵95%
试用
1080p · 无音频
Google官方
$0.05 / 秒
试用
1080p · 含音频
Google官方
$0.08 / 秒
试用
4 秒 · 720p · 含音频
Google官方
$0.0500 / 秒
试用
NanoAPI
$0.0585 / 秒贵17%
试用
KIE
$0.0188 / 秒省63%
接口耗时 1分钟
1分钟试用
6 秒 · 720p · 含音频
Google官方
$0.0500 / 秒
试用
NanoAPI
$0.0585 / 秒贵17%
试用
KIE
$0.0125 / 秒省75%
接口耗时 1分钟
1分钟试用
8 秒 · 720p · 含音频
Google官方
$0.0500 / 秒
试用
NanoAPI
$0.0585 / 秒贵17%
试用
KIE
$0.0094 / 秒省81%
接口耗时 1分钟
1分钟试用

自动路由与故障切换

用一个模型 ID 调用 Veo 3.1 Lite,Yir 为每个任务在 Google、NanoAPI和KIE 中选渠道:交给当前估价最低的合格渠道,按该渠道的公开价收费、不加价。某个渠道的尝试确认失败时,在你设置的 max_cost 内换渠道重试。请求里不用写路由参数。 路由与故障转移文档

计价说明

按实际执行渠道计费;故障转移时可能切换渠道,费用和耗时随之变化。

API 接入

交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。

让编码 Agent 接入

复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。

添加 Yir MCP 服务器

接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 Veo 3.1 Lite;它会先报价,你确认后才生成。

https://gateway.yir.ai/mcp
各客户端接入步骤

Claude Code 一行命令

先在控制台创建 API Key 并设为环境变量 YIR_API_KEY,再运行:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

安装 Yir Skill

在 Agent 运行环境里设好 YIR_API_KEY,装进 Claude Code、Codex 等编码 Agent 后,直接说“用 Yir 的 Veo 3.1 Lite 生成……”。

npx skills add yir-ai/skills
了解 Yir Skill

通过包管理器安装官方 SDK,或直接复制下方代码进行集成

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// 默认从环境变量读取 YIR_API_KEY: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 提交视频生成任务
const job = await client.submitVideo({
model: "google/veo-3.1-lite-generate-001",
input: {
type: "text",
prompt: "一只海龟缓缓游过珊瑚礁,镜头从侧面平稳跟随,阳光穿过清澈海水,在龟背上形成流动的光纹",
},
parameters: {
duration: 8,
resolution: "720p",
aspect_ratio: "16:9",
generate_audio: true,
n: 1,
},
});
 
// 2. 等待任务完成并交付结果
const result = await client.waitForJob(job.id);
console.log("交付文件:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

已按 OpenAI 协议对接的项目,或 new-api 等网关,只需更换 Base URL 和 Key。 OpenAI 兼容说明

OpenAI SDK base_url
https://gateway.yir.ai/openai/v1
new-api 渠道 Base URL
https://gateway.yir.ai/openai
密钥
Yir API Key
模型 ID
google/veo-3.1-lite-generate-001
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1-lite-generate-001",
    "prompt": "一只海龟缓缓游过珊瑚礁,镜头从侧面平稳跟随,阳光穿过清澈海水,在龟背上形成流动的光纹",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "8"
  }'

参数概览

常用参数,具体限制以当前模型及所选渠道为准

API 文档
分辨率
resolution
  • 720p
  • 1080p

成图或成片的分辨率档位,更高规格拥有更多像素细节,按档位计费

宽高比
aspect_ratio
  • 16:9
  • 9:16

画面几何比例,建议依据展示媒介(手机竖屏、横屏横幅或方形)指定

输入方式
input_mode
  • 文字生成
  • 图片输入

参考素材的数量与格式以当前模型及所选渠道支持范围为准

时长
duration
  • 4 秒
  • 6 秒
  • 8 秒

视频输出时长规格,按秒或固定档位计费

音频
generate_audio
  • 可选

可选生成与视频同步的原生音频轨道

参考素材
references
  • first_frame ≤ 1

各输入方式下的参考素材数量上限,以所选渠道为准;价格表中的数量仅为计价示例,不代表支持上限或免费额度

常见问题

开始使用 Veo 3.1 Lite

同规格跨渠道比价,一个钱包调用多个渠道。