
Kling 3.0 Turbo 是快手 Kling 3 系列中主打速度与成本的档位。输入提示词或一张首帧图,即可生成 3–15 秒、720p / 1080p 的视频,动作质量与同系列一致。
Kling v3 Turbo
Kling视频
发布时间2026年6月
official-kling-v3-motion-controlKling 3.0 Motion Control 把参考视频里的动作迁移到角色图上,保留表演者的节奏与身体语言,并可选择角色朝向与背景来源。
使用模型 official-kling-v3-motion-control 发起一次创建请求,再轮询结果接口。所有请求共用同一个 API Key 与美元余额余额。
可直接运行:提交任务后轮询,直到任务完成。
#!/usr/bin/env bash
set -euo pipefail
I2V_API_KEY="${I2V_API_KEY:?Set your API key: export I2V_API_KEY=...}"
# 1. Submit task
RESPONSE=$(curl -s -X POST "https://i2v.ai/api/v1/jobs/createTask" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $I2V_API_KEY" \
-d '{
"model": "official-kling-v3-motion-control",
"inputs": {
"prompt": "A calm lake at sunrise",
"resolution": "720p",
"duration": 5
}
}')
TASK_ID=$(echo "$RESPONSE" | grep -o '"taskId":"[^"]*"' | cut -d'"' -f4)
echo "Task created: $TASK_ID"
# 2. Poll until complete
while true; do
RESULT=$(curl -s "https://i2v.ai/api/v1/jobs/recordInfo?taskId=...?taskId=$TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY")
STATUS=$(echo "$RESULT" | grep -o '"status":"[^"]*"' | head -1 | cut -d'"' -f4)
case "$STATUS" in
success) echo "$RESULT"; break ;;
fail) echo "Failed: $RESULT"; exit 1 ;;
*) echo "Status: $STATUS — waiting..."; sleep 2 ;;
esac
done/api/v1/jobs/createTask创建生成任务并返回 taskId。
/api/v1/jobs/recordInfo?taskId=...按 taskId 查询单个任务,轮询到 success 或 fail。
/api/v1/account返回 API Key 所属账号的当前美元余额余额。
8 个字段
| 参数 | 必填 | 类型 | 取值 | 默认值 | 说明 |
|---|---|---|---|---|---|
| prompt | 否 | string | ≤ 2500 chars | 未记录 | 可选的表演或画面引导。 |
| imageUrl | 否 | string | 未记录 | 未记录 | 单张公开图片 URL。默认作为首帧,请求声明参考模式时作为参考图。 |
| uploadedUrls | 否 | string[] | ≤ 1 | 未记录 | 恰好一张角色图,脸部、肩部与躯干需清晰可见。 |
| imageUrls | 否 | string[] | ≤ 1 | 未记录 | 额外的公开图片 URL,与 uploadedUrls 合并并按请求顺序去重。 |
| duration | 否 | number | 3–15 s | 未记录 | 输出时长(秒),必须是模型允许的取值。 |
| outputResolution | 否 | enum | 720p, 1080p | 720p | 输出分辨率。 |
| callBackUrl | 否 | string | 未记录 | 未记录 | 完成回调的 HTTPS 地址;属于请求体顶层字段,不放在 inputs 内。 |
| expectedRevision | 否 | number | 未记录 | 未记录 | 客户端期望的模型配置版本号;不一致返回 HTTP 409 conflict;属于请求体顶层字段。 |
{
"taskId": "..."
}{
"taskId": "...",
"model": "official-kling-v3-motion-control",
"status": "success",
"creditsUsed": 100,
"output": [
{
"url": "...",
"width": 1280,
"height": 720
}
],
"error": null,
"createTime": 1760000000000,
"completeTime": 1760000060000
}{
"code": "invalid_params",
"message": "Invalid request parameters"
}| 状态值 | 说明 |
|---|---|
| waiting | 任务排队中 |
| generating | 生成处理中 |
| success | 结果已就绪 |
| fail | 生成失败 |
| 错误码 | HTTP | 说明 |
|---|---|---|
| invalid_params | 400 | 请求体、inputs 或模型 ID 不合法。 |
| unauthorized | 401 | API Key 缺失、无效或已过期。 |
在 Authorization 请求头中以 Bearer Token 传入 API Key。可在「设置 → API 密钥」中创建和吊销。
请求头需包含 Authorization: Bearer API_KEY 与 Content-Type: application/json;同一逻辑创建复用同一个 Idempotency-Key,相同键但请求体不同会被拒绝。
Authorization: Bearer $I2V_API_KEYContent-Type: application/jsonIdempotency-Key: <uuid>| insufficient_credits | 402 | 可用美元余额不足;响应可能附带 required 与 available。 |
| access_denied | 403 | 任务属于其他账号,或账号/权益不可用。 |
| not_found | 404 | 任务不存在。 |
| conflict | 409 | expectedRevision 与服务端不一致,或幂等键被用于不同请求体。 |
| concurrency_limit | 429 | 账号并发任务数达到上限。 |
| rate_limit | 429 | 账号每分钟提交次数达到上限。 |
| internal_error | 500 | 未预期的服务端错误。 |
| service_unavailable | 503 | 鉴权或上游依赖服务暂不可用。 |