Kling/v3
Kling v3 系列视频生成模型，统一使用 kling-v3 模型 ID，根据入参自动路由到下列三种生成模式：
文生视频（t2v）：仅传
prompt图生视频（i2v）：传入参考图（首帧或首尾帧）
运动控制（motion_control）：同时传入参考图与参考视频，由参考视频驱动角色运动
也可以通过 parameters.kling_v3_type 显式指定模式，详见下方”模式选择”。
模式选择
服务端按以下优先级判定本次请求走哪种模式：
parameters.kling_v3_type显式指定时优先生效，可选值：t2v/i2v/motion_control未显式指定时按入参隐式推导：
input.video_url非空 →motion_control存在任一首帧图字段（
parameters.image/input.images/input.first_frame_url/input.img_url）→i2v否则 →
t2v
推荐生产环境直接传
kling_v3_type显式指定，避免未来字段语义变化导致的隐式路由偏差。
异步提交任务
接口
https://api.modelverse.cn/v1/tasks/submit
输入
通用参数
文生视频 / 图生视频 模式专属参数（t2v / i2v）
运动控制 模式专属参数（motion_control）
请求示例
⚠️ 如果您使用 Windows 系统，建议使用 Postman 或其他 API 调用工具。
文生视频（t2v，不传 image）：
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"input": {
"prompt": "A beautiful sunset over the ocean with waves gently crashing"
},
"parameters": {
"kling_v3_type": "t2v",
"mode": "pro",
"aspect_ratio": "16:9",
"duration": 5,
"sound": "on"
}
}'图生视频（i2v，传入 image 作为首帧）：
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"input": {
"prompt": "The image comes to life with gentle movement"
},
"parameters": {
"kling_v3_type": "i2v",
"mode": "pro",
"duration": 5,
"image": "https://example.com/first_frame.jpg"
}
}'首尾帧控制（i2v，同时传入 image 和 image_tail）：
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"input": {
"prompt": "A girl walking through a garden"
},
"parameters": {
"kling_v3_type": "i2v",
"mode": "pro",
"duration": 5,
"image": "https://example.com/first_frame.jpg",
"image_tail": "https://example.com/last_frame.jpg"
}
}'多镜头生成（t2v）：
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v3",
"parameters": {
"kling_v3_type": "t2v",
"mode": "pro",
"aspect_ratio": "16:9",
"duration": 5,
"multi_shot": true,
"shot_type": "customize",
"multi_prompt": [
{"index": 1, "prompt": "A person walking through a misty forest at dawn", "duration": "2"},
{"index": 2, "prompt": "A car speeding down a rainy street, headlights glowing", "duration": "3"}
],
"sound": "on"
}
}'运动控制（motion_control，参考图 + 参考视频）：
curl -X POST 'https://api.modelverse.cn/v1/tasks/submit' \
-H 'Authorization: <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-v3",
"input": {
"img_url": "https://example.com/character.jpg",
"video_url": "https://example.com/motion_reference.mp4",
"prompt": "A person dancing gracefully"
},
"parameters": {
"kling_v3_type": "motion_control",
"duration": 5,
"aspect_ratio": "16:9",
"character_orientation": "image",
"mode": "std"
}
}'输出
响应示例
{
"output": {
"task_id": "task_id"
},
"request_id": "request_id"
}查询任务状态
接口
https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>
请求示例
curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'输出
响应示例（成功）
{
"output": {
"task_id": "task_id",
"task_status": "Success",
"urls": ["https://xxxxx/xxxx.mp4"],
"submit_time": 1756959000,
"finish_time": 1756959050
},
"usage": {
"duration": 5
},
"request_id": ""
}响应示例（失败）
{
"output": {
"task_id": "task_id",
"task_status": "Failure",
"submit_time": 1756959000,
"finish_time": 1756959019,
"error_message": "error_message"
},
"usage": {
"duration": 5
},
"request_id": ""
}
