全部模型
Kling · 媒体 API
Kling 3.0 API
Kling 3.0 是 Kling 在 OmniaKey 上的视频线路:支持文生视频和首帧(可选尾帧)生视频,分标准与高品质两档,时长固定为 5、10 或 15 秒。
- 模型 ID
- kling-3.0
- 提供商
- Kling
- 类型
- AI 视频
- 每次成功调用
- $0.80–$3.00
- 最近核验
- 2026-09-16
01
适用场景
已知成片时长时选 Kling 3.0:5/10/15 秒下标准档每次 $0.80/$1.60/$2.40,高品质档 $1.00/$2.00/$3.00。mode 为必填参数,图生视频的画幅由首帧决定。
02
能力范围
文生视频
kling-3.0
根据文字提示词生成一段短视频。
图生视频
kling-3.0
把静态图片动起来,生成一段短视频。
03
接入方式
媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。
创建、轮询、下载
# 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)"04
价格
视频任务按实际输出的秒数计费,不按 Token 计费;失败或取消的任务会自动退款。
每次成功调用
$0.80–$3.00每次调用
mode | duration
- std|5
- $0.80每次调用
- std|10
- $1.60每次调用
- std|15
- $2.40每次调用
- pro|5
- $1.00每次调用
- pro|10
- $2.00每次调用
- pro|15
- $3.00每次调用
Kling 的更多模型
Kling 3.0 Turbo
kling-3-turbo
常见问题
如何在 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,再读取签名后的资源地址。
