Kling 3.0 API
AI 视频Kling 3.0 是 Kling 在 OmniaKey 上的视频线路:支持文生视频和首帧(可选尾帧)生视频,分标准与高品质两档,时长固定为 5、10 或 15 秒。
- 每次成功调用$0.80–$3.00
- 操作文生视频
- 图生视频
- 查看工具价格与计费规则
运行模型后,结果会显示在这里。
01
适用场景
Kling 3.0 是 Kling 在 OmniaKey 上的视频线路:支持文生视频和首帧(可选尾帧)生视频,分标准与高品质两档,时长固定为 5、10 或 15 秒。
已知成片时长时选 Kling 3.0:5/10/15 秒下标准档每次 $0.80/$1.60/$2.20,高品质档 $1.00/$2.00/$3.00。mode 为必填参数,图生视频的画幅由首帧决定。
02
能力范围
文生视频
kling-3.0
根据文字提示词生成一段短视频。
图生视频
kling-3.0
把静态图片动起来,生成一段短视频。
03
深入了解
Kling 3.0 是 OmniaKey 上的固定时长视频模型,ID 为 kling-3.0。每次请求要选一个质量档(标准或高品质)和一个时长(只能是 5、10 或 15 秒),费用按“档位×时长”这张表里的一格计,与渲染实际耗时无关。
它能做提示词生成,也能拿一张首帧做动画。它没有参考输入操作,reference_to_video 请求在任务创建前就会被拒。由于图生视频的画幅来自所给的静帧,aspect_ratio 只在文生视频下有效,可选 16:9、9:16 与 1:1。
2026 年 10 月 25 日,我们用三条 5 秒 720p 提示词把它和 Wan 3.0 对比:滑板动作那条 Kling 赢,面摊与香水环绕两条输了。这些结果、各自耗时,以及更早一次被拒的首帧,都记在下方。
特技与运动镜头
同一条提示词下,Kling 让滑手按写好的路线越过水洼并稳稳落地,Wan 则把板落进了水里。动作是否照脚本执行比场景是否好看更关键时,先试这一档,并把机位要求写清楚。
渲染前锁定预算
费用是档位与时长那张表里的一格,所以在出第一帧之前就能让客户确认金额。时长要在 5、10、15 里一次选定,其他数值会被直接拒绝,而不是自动裁到最近的档位。
给静帧加动作
首帧用可公开访问的 HTTPS 链接传入,也可以再给一张尾帧作为落点。画幅由静帧决定,所以按最终比例裁好再传;288x288 这样的缩略图低于像素下限,会失败。
04
实测记录
在 2026 年 10 月 25 日的三条提示词测试中,Kling 3.0 有三条中的两条输给 Wan 3.0,只赢下那条滑板动作镜头。
阅读实测记录同样三条提示词,Kling 3.0 的完成时间中位数为 193.6 秒,Wan 3.0 为 144.2 秒。
阅读实测记录我们向 Kling 3.0 发送 reference_to_video 请求时,它在任何任务创建之前就返回 HTTP 400,因此没有扣费。
阅读实测记录Kling 3.0 以像素尺寸错误拒绝了一张 288x288 的首帧并退回该任务,而 1200x630 与 1280x720 的帧通过了。
阅读实测记录2026 年 9 月 16 日的快速验证中,一条 15 秒标准档 Kling 3.0 文生视频任务返回了 13,753,392 字节的 MP4,视频为 H.264、音频为 AAC。
05
需要预留的限制
- 只接受 5、10、15 秒。没有 20 秒或 30 秒的格子,8 秒这类中间值会在任务创建前被拒,剪接节奏要围绕这三个长度设计。
- 没有参考图或参考视频。首帧是片段的开头,不是风格参考;参考类调用返回 HTTP 400,不会生成任务。
- 首帧有像素下限:288x288 的测试图在生成阶段失败并被退回,起点至少要是 1200x630 的静帧。
- 声音默认就有:2026 年 9 月 16 日的快速验证中,一条 15 秒标准档文生视频任务没有要求声音,返回的 MP4 仍带 AAC 音轨,所以要提前安排声音,或者下载后抽掉音轨。
06
对比相近模型
| 模型 | 更适合 | 操作 | 标价 |
|---|---|---|---|
| Kling 3.0当前页 kling-3.0 | 5、10 或 15 秒固定时长,渲染前就能确定单次费用。 | 文生视频 · 图生视频 | $0.80–$3.00 每次调用 |
| Wan 3.0 wan3.0-video | 按秒计费、最长 30 秒,并且提供这一档没有的参考输入。 | 文生视频 · 图生视频 · 参考生视频 | $0.04–$0.16 每秒 |
| HappyHorse 1.1 happyhorse-1.1 | 三个现成变体,覆盖 480P、720P、1080P,支持参考输入。 | 文生视频 · 图生视频 · 参考生视频 | $0.042–$0.108 每秒 |
07
来源与核验
指南更新于 2026-10-27。
08
接入方式
媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: kling-3.0-001" \
-d '{
"model": "kling-3.0",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The same model id and the same poll loop serve the other operations:
# image_to_video media[] type "first_frame"
# Reference media travel alongside the prompt:
# {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
# A public HTTPS URL or a base64 data URI both work.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"09
价格
视频任务按实际输出的秒数计费,不按 Token 计费;失败或取消的任务会自动退款。
$0.80–$3.00每次调用
mode | duration
- std|5
- $0.80每次调用
- std|10
- $1.60每次调用
- std|15
- $2.20每次调用
- pro|5
- $1.00每次调用
- pro|10
- $2.00每次调用
- pro|15
- $3.00每次调用
Kling 的更多模型
Kling 3.0 Turbo
kling-3-turbo
相关文章
Kling 3.0 API:文生视频的请求代码和实测片段
一次 POST、模型填 kling-3.0,就是一条文生视频任务。下面是请求代码、请求体里的字段,以及我们 2026 年 10 月 29 日实跑并测量过的两条 5 秒片段。
阅读文章可灵 3.0 提示词怎么写:结构、示例和实测成片
四条提示词、四段真跑的视频:切镜落在哪里、台词有没有出来、镜头哪里没动。
阅读文章HappyHorse 1.1 vs 可灵 3.0:同一提示词实测对比与价格
三条提示词:HappyHorse 1.1 赢了夜市和香水瓶,可灵 3.0 把滑板动作做对了。
阅读文章可灵 3.0 vs Wan 3.0:同一提示词实测对比与价格
三条提示词、两个视频模型、同一天:各自出了什么,花了多少钱。
阅读文章常见问题
如何在 OmniaKey 上调用 Kling 3.0?
向 /v1/media/tasks 发送 POST,带上模型 ID、type 设为 "video"、operation 设为 "text_to_video";若用首帧图生视频,改为 "image_to_video",并把首帧放入 input.media[](type 设为 "first_frame")。重试时复用同一个 Idempotency-Key,超时就不会再生成第二笔付费任务。
Kling 3.0 如何收费?
Kling 3.0 按生成视频的时长计费:$0.80–$3.00 每次调用。创建时会按请求时长从预付余额中预扣,失败或取消的任务会自动退款。
为什么接口返回任务 ID 而不是视频?
视频渲染大约需要一分钟到几分钟,OmniaKey 因此把所有视频路由统一为同一套异步流程。轮询 GET /v1/media/tasks/{id},直到状态变为 succeeded,再读取签名后的资源地址。
为什么图生视频时它拒绝 aspect_ratio?
因为静帧本身已经决定了画幅。图生视频的比例取自首帧,只有文生视频才接受显式的 aspect_ratio,取值为 16:9、9:16 与 1:1。需要别的形状,请在传图之前把静帧裁好。
mode 是必填参数吗?
是。每次请求都要给 mode(std 或 pro)与 duration;按 Kling 的文档,标准档输出 720P、高品质档输出 1080P,所以选档位也就是选画面尺寸,此外没有单独的分辨率字段。目录按档位与时长计价,当前费率写在模型页的价格表里。
能用参考图吗?
不能。目录里只列了文生视频与图生视频,reference_to_video 会在任务创建前返回 HTTP 400,因此这次尝试不扣费。镜头需要跟随角色设定图时,改用 Seedance、Wan 3.0 或 HappyHorse。
首帧太小会怎样?
提供方会以像素尺寸错误拒绝,任务随后退回。288x288 的测试图就是这样失败的,而 1200x630 与 1280x720 的帧通过。请按正常画幅导出静帧,不要拿缩略图或图标凑数。
Kling 3.0 会生成声音吗?
会,音轨默认就有。2026 年 9 月 16 日的快速验证中,一条 15 秒标准档文生视频任务返回的 MP4 带 H.264 画面与 AAC 音轨,而那次请求并没有要求声音。需要的环境声写进提示词,剪辑要静音就事后抽掉音轨。
