图生视频-异步 (可灵)

POST

/v1/video/generations

可灵图生视频模型，具体可用参数请参考：https://app.klingai.com/cn/dev/document-api/apiReference/model/imageToVideo
此接口为创建任务接口，不会直接返回生产的视频地址，还需要配合查询任务接口，通过轮询获取视频地址。
具体使用方法请参考示例代码中的【Python 图生视频】

请求参数

Header 参数

Body 参数application/json

示例

Mask首尾帧

{
   "model_name": "kling-v2-5-turbo",
   "mode": "pro",
   "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
   "size": "1920x1080",
   "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
   "duration": 5,
   "static_mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888177/cOLNrShrSO/static_mask.png",
   "dynamic_masks": [
      {
         "mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888130/WU8spl23dA/dynamic_mask_1.png",
         "trajectories": [
            {
               "x": 279,
               "y": 219
            },
            {
               "x": 417,
               "y": 65
            }
         ]
      }
   ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Mask首尾帧

curl --location --request POST 'https://api.wenwen-ai.com/v1/video/generations' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "model_name": "kling-v2-5-turbo",
   "mode": "pro",
   "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
   "size": "1920x1080",
   "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
   "duration": 5,
   "static_mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888177/cOLNrShrSO/static_mask.png",
   "dynamic_masks": [
      {
         "mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888130/WU8spl23dA/dynamic_mask_1.png",
         "trajectories": [
            {
               "x": 279,
               "y": 219
            },
            {
               "x": 417,
               "y": 65
            }
         ]
      }
   ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "812484543680102478",
        "action": "generate",
        "status": "SUCCESS",
        "fail_reason": "https://v2-kling.kechuangai.com/bs2/upload-ylab-stunt/6620b012-a6f9-46e0-85ec-79d0b8862f39-1Nd7uCpkkpgQIXqcpE8fpg-output.mp4?x-kcdn-pid=112452",
        "submit_time": 1761739929,
        "start_time": 1761739941,
        "finish_time": 1761740002,
        "progress": "100%",
        "data": {
            "code": 0,
            "data": {
                "task_id": "812484543680102478",
                "task_info": {},
                "created_at": 1761739929228,
                "updated_at": 1761739996983,
                "task_result": {
                    "videos": [
                        {
                            "id": "812484543835279382",
                            "url": "https://v2-kling.kechuangai.com/bs2/upload-ylab-stunt/6620b012-a6f9-46e0-85ec-79d0b8862f39-1Nd7uCpkkpgQIXqcpE8fpg-output.mp4?x-kcdn-pid=112452",
                            "duration": "5.041"
                        }
                    ]
                },
                "task_status": "succeed",
                "task_status_msg": ""
            },
            "message": "SUCCEED",
            "request_id": "9b16db8d-bfba-4fb6-a81f-214736a277f5"
        }
    }
}

修改于 2025-12-07 15:50:49

文生视频-异步 (可灵)

语音回复(chat)