Kling v3 Turbo
使用此模型提交视频生成任务,再通过返回的任务 ID 查询结果。
模型 ID official-kling-v3-turbo
快速开始
创建 并设置 I2V_API_KEY。每个新任务设置一个 IDEMPOTENCY_KEY,重试同一次提交时复用原幂等键和请求体。
提交任务
POST https://api.i2v.ai/api/v1/jobs/createTask
bash
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "official-kling-v3-turbo",
"inputs": {
"prompt": "A calm lake at sunrise",
"duration": 5,
"resolution": "720p",
"aspectRatio": "16:9"
}
}'HTTP 200 表示任务已受理。保存返回的 taskId。
json
{"taskId":"YOUR_TASK_ID"}查询结果
bash
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"将 YOUR_TASK_ID 替换为返回的任务 ID。状态为 waiting 或 generating 时退避轮询。success 时读取 output[].url,fail 时检查 error。
请求参数
模型输入放在 inputs 对象中。素材 URL 需要可公开访问。必需素材及参数组合取决于具体生成模式。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
inputs.prompt | string | 否 | — | 镜头描述,运镜与主体动作会被严格遵循。 上限 2500 字符. |
inputs.resolution | string | 否 | 720p | 输出分辨率。 可选值 720p, 1080p. |
inputs.aspectRatio | string | 否 | 16:9 | 输出宽高比。 可选值 16:9, 9:16, 1:1. |
inputs.duration | number | 否 | 5 | 视频时长,单位为秒。 可选值 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. |
inputs.urls | string[] | 否 |

