Kling 3.0 异步视频 API
Kling 3.0 系列通过统一的 POST /v1/video/tasks 创建异步视频任务。Kling 3.0 支持纯文本生成和可选的首帧/尾帧参考；Kling 3.0 Omni 除了首尾帧，还支持最多三张图片共同影响画面内容和风格。
本章节只介绍新版异步接口。其他 Kling 兼容接口及其文档保持不变。
模型
| 模型 | 固定分辨率 | 时长 | 参考模式 |
|---|---|---|---|
adobe-kling-3.0-720p | 720p | 3-15 秒整数 | frame，0-2 张图 |
adobe-kling-3.0-1080p | 1080p | 3-15 秒整数 | frame，0-2 张图 |
adobe-kling-3.0-omni-720p | 720p | 3-15 秒整数 | frame 最多 2 图，或 images 最多 3 图 |
adobe-kling-3.0-omni-1080p | 1080p | 3-15 秒整数 | frame 最多 2 图，或 images 最多 3 图 |
四个模型只支持 16:9 和 9:16。分辨率由完整模型名固定，请勿传 output.resolution。
视频提示词最多 1200 个 Unicode 字符。output.generate_audio 控制成片音轨，省略时默认启用。
以模型列表为准
管理员可能按账号、Token 或分组开放不同模型。调用前请查询 GET /v1/models，不要只依赖文档中的模型示例。
bash
curl -sS "$SUPERTOKEN_BASE_URL/v1/models" \
-H "Authorization: Bearer $SUPERTOKEN_KEY" |
jq '.data[] | select(.id | startswith("adobe-kling-3.0"))'frame 与 images
| 模式 | 支持模型 | 图片含义 |
|---|---|---|
frame | Kling 3.0、Kling 3.0 Omni | 0 张为纯文本生成；第 1 张是首帧，第 2 张是尾帧 |
images | 仅 Kling 3.0 Omni | 1-3 张普通参考图，不映射为首尾帧 |
frame 模式不传图片时为纯文本生成。使用帧参考时，推荐把首帧放在 input.image，尾帧放在 input.reference_images[0]。images 模式使用 input.reference_images[]。
Kling 3.0 不支持 images，Kling 系列也不支持 Seedance 的 media 模式，因此不要传 reference_videos 或 reference_audios。
文档导航
| 页面 | 内容 |
|---|---|
| 异步任务与示例 | 纯文本、单帧、首尾帧、Omni 三图、轮询和直链结果 |
| 参数与错误 | 字段、模型能力、计费和常见错误 |
| 视频 Webhook | 成功/失败事件、鉴权、去重和接收代码 |
开始之前
bash
export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export RESOURCE_API_KEY="YOUR_RESOURCE_API_KEY"
export VIDEO_MODEL="adobe-kling-3.0-720p"- 创建任务使用模型 API Token，
sk-...。 - 查询任务和受保护资源使用资源 API Key，
ak_...。 - Webhook 接收端验证使用 Webhook Key，
wk-...。
最小示例
Kling 3.0 可以只使用提示词生成视频：
bash
curl -sS "$SUPERTOKEN_BASE_URL/v1/video/tasks" \
-H "Authorization: Bearer $SUPERTOKEN_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: kling-text-20260802-001" \
-d '{
"model": "'"$VIDEO_MODEL"'",
"operation": "generation",
"input": {
"prompt": "一辆红色跑车沿海岸公路缓慢行驶，日出，电影感运镜"
},
"output": {
"duration": 3,
"aspect_ratio": "16:9"
}
}'创建成功返回 202 Accepted。保存响应中的 id，使用资源 API Key 查询，或配置视频 Webhook接收终态通知。