Kling 3.0 Omni API

可灵 3.0 Omni 统一多模态视频模型,支持文生、首尾帧图生与最多 7 个参考图或主体的参考生视频,最高 4K、3–15 秒

720p · 无音频
APIMart $0.0672 / 秒
官方$0.084省20%
720p · 含音频
APIMart $0.0896 / 秒
官方$0.112省20%
1080p · 无音频
APIMart $0.0896 / 秒
官方$0.112省20%
1080p · 含音频
APIMart $0.112 / 秒
官方$0.14省20%

价格比较

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

比较其他模型
输出规格渠道渠道公开价接口耗时试用
720p · 无音频
Kling AI官方
$0.0840 / 秒
仅为参考价,不能通过 Yir 调用
FAL
$0.0840 / 秒
试用
KIE
$0.0755 / 秒省10%
试用
APIMart
$0.0672 / 秒省20%
试用
720p · 含音频
Kling AI官方
$0.1120 / 秒
仅为参考价,不能通过 Yir 调用
FAL
$0.1120 / 秒
试用
KIE
$0.1010 / 秒省10%
试用
APIMart
$0.0896 / 秒省20%
试用
1080p · 无音频
Kling AI官方
$0.1120 / 秒
仅为参考价,不能通过 Yir 调用
FAL · pro
$0.1120 / 秒
试用
KIE
$0.1010 / 秒省10%
试用
APIMart
$0.0896 / 秒省20%
试用
1080p · 含音频
Kling AI官方
$0.140 / 秒
仅为参考价,不能通过 Yir 调用
FAL · pro
$0.140 / 秒
试用
KIE
$0.126 / 秒省10%
试用
APIMart
$0.112 / 秒省20%
试用
4K
Kling AI官方
$0.4200 / 秒
仅为参考价,不能通过 Yir 调用
APIMart
$0.4286 / 秒贵2%
试用
FAL · native4k
$0.4200 / 秒
试用
KIE
$0.3775 / 秒省10%
试用

自动路由与故障切换

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

计价说明

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

API 接入

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

让编码 Agent 接入

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

添加 Yir MCP 服务器

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

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 的 Kling 3.0 Omni 生成……”。

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: "klingai/kling-3.0-omni",
input: {
type: "text",
prompt: "一只海龟缓缓游过珊瑚礁,镜头从侧面平稳跟随,阳光穿过清澈海水,在龟背上形成流动的光纹",
},
parameters: {
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
generate_audio: false,
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
klingai/kling-3.0-omni
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "klingai/kling-3.0-omni",
    "prompt": "一只海龟缓缓游过珊瑚礁,镜头从侧面平稳跟随,阳光穿过清澈海水,在龟背上形成流动的光纹",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'

参数概览

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

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

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

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

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

输入方式
input_mode
  • 文字生成
  • 参考素材输入
  • 图片输入

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

时长
duration
  • 3–15 秒

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

音频
generate_audio
  • 可选

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

参考素材
references
  • first_frame ≤ 1
  • last_frame ≤ 1
  • reference_image ≤ 7

最多 7 个角色:给 2–4 张图设同一个 subject 名,提示词里按名字调用

常见问题

开始使用 Kling 3.0 Omni

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