图生视频

{
  "header": [
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "3tYQJEll7U",
      "enable": true,
      "name": "Content-Type",
      "sampleValue": "application/json"
    },
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "MTunJbdcIi",
      "enable": true,
      "name": "Authorization",
      "sampleValue": "Bearer {{YOUR_API_KEY}}"
    }
  ]
}

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "model_name": {
        "type": "string",
        "description": "模型名称 枚举值：kling-v1, kling-v1-5, kling-v1-6, kling-v2-master, kling-v2-1, kling-v2-1-master, kling-v2-5-turbo,kling-v2-6,kling-v3"
      },
      "image": {
        "type": "string",
        "description": "参考图像 支持传入图片Base64编码或图片URL（确保可访问）"
      },
      "image_tail": {
        "type": "string",
        "description": "参考图像 - 尾帧控制 支持传入图片Base64编码或图片URL（确保可访问）"
      },
      "prompt": {
        "type": "string",
        "description": "正向文本提示词不能超过2500个字符\n用<<<voice_1>>>来指定音色，序号同voice_list参数所引用音色的排列顺序\n一次视频生成任务至多引用2个音色；指定音色时，sound参数值必须为on语法结构越简单越好，\n如：男人<<<vocie_1>>>说：“你好”\n当voice_list参数不为空且prompt参数中引用音色ID时，视频生成任务按“有指定音色”计量计费"
      },
      "negative_prompt": {
        "type": "string",
        "description": "负向文本提示词"
      },
      "voice_list": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "voice_id": {
              "type": "string"
            }
          },
          "x-apifox-orders": [
            "voice_id"
          ]
        },
        "description": "仅V2.6及后续版本模型支持当前参数生成视频时所引用的音色的列表\n一次视频生成任务至多引用2个音色\n当voice_list参数不为空且prompt参数中引用音色ID时，视频生成任务按“有指定音色”计量计费"
      },
      "sound": {
        "type": "string",
        "description": "仅V2.6及后续版本模型支持当前参数生成视频时是否同时生成声音\n枚举值：on，off"
      },
      "cfg_scale": {
        "type": "number",
        "description": "kling-v2.x模型不支持当前参数生成视频的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强"
      },
      "mode": {
        "type": "string",
        "description": "生成视频的模式\n枚举值：std，pro\n其中std：标准模式（标准），基础模式，性价比高\n其中pro：专家模式（高品质），高表现模式，生成视频质量更佳"
      },
      "static_mask": {
        "type": "string",
        "description": "静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）"
      },
      "multi_shot": {
        "type": "boolean",
        "description": "是否生成多镜头视频\n当前参数为true时，prompt参数无效\n当前参数为false时，shot_type参数及multi_prompt参数无效"
      },
      "shot_type": {
        "type": "string",
        "description": "分镜方式\n枚举值：customize\n当multi_shot参数为true时，当前参数必填"
      },
      "multi_prompt": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "index": {
              "type": "integer"
            },
            "prompt": {
              "type": "string"
            },
            "duration": {
              "type": "string"
            }
          },
          "required": [
            "index",
            "prompt",
            "duration"
          ],
          "x-apifox-orders": [
            "index",
            "prompt",
            "duration"
          ]
        },
        "description": "各分镜信息，如提示词、时长等\n● 通过index、prompt、duration参数定义分镜序号及相应提示词和时长，其中：\n\t○ 最多支持6个分镜，最小支持1个分镜\n\t○ 每个分镜相关内容的最大长度不超过512\n\t○ 每个分镜的时长不大于当前任务的总时长，不小于1\n\t○ 所有分镜的时长之和等于当前任务的总时长"
      },
      "dynamic_masks": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "mask": {
              "type": "string"
            },
            "trajectories": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "x": {
                    "type": "integer"
                  },
                  "y": {
                    "type": "integer"
                  }
                },
                "required": [
                  "x",
                  "y"
                ],
                "x-apifox-orders": [
                  "x",
                  "y"
                ]
              }
            }
          },
          "x-apifox-orders": [
            "mask",
            "trajectories"
          ]
        },
        "description": "动态笔刷配置列表"
      },
      "camera_control": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "properties": {
              "horizontal": {
                "type": "integer"
              },
              "vertical": {
                "type": "integer"
              },
              "pan": {
                "type": "integer"
              },
              "tilt": {
                "type": "integer"
              },
              "roll": {
                "type": "integer"
              },
              "zoom": {
                "type": "integer"
              }
            },
            "required": [
              "horizontal",
              "vertical",
              "pan",
              "tilt",
              "roll",
              "zoom"
            ],
            "x-apifox-orders": [
              "horizontal",
              "vertical",
              "pan",
              "tilt",
              "roll",
              "zoom"
            ]
          }
        },
        "required": [
          "type",
          "config"
        ],
        "x-apifox-orders": [
          "type",
          "config"
        ],
        "description": "控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配）"
      },
      "duration": {
        "type": "string",
        "description": "生成视频时长，单位s\n枚举值：5，10"
      },
      "watermark_info": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "x-apifox-orders": [
          "enabled"
        ],
        "description": "是否同时生成含水印的结果\n● 通过enabled参数定义，用key:value承载，如下：：\n\"watermark_info\": {\n \t\"enabled\": boolean // true 为生成，false 为不生成\n}"
      },
      "callback_url": {
        "type": "string"
      },
      "external_task_id": {
        "type": "string"
      }
    },
    "required": [
      "model_name",
      "duration",
      "image",
      "mode"
    ],
    "x-apifox-orders": [
      "model_name",
      "image",
      "image_tail",
      "prompt",
      "negative_prompt",
      "voice_list",
      "sound",
      "cfg_scale",
      "mode",
      "static_mask",
      "multi_shot",
      "shot_type",
      "multi_prompt",
      "dynamic_masks",
      "camera_control",
      "duration",
      "watermark_info",
      "callback_url",
      "external_task_id"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\r\n    \"model_name\": \"kling-v1\",\r\n    \"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\",\r\n    \"image_tail\": \"\",\r\n    \"prompt\": \"\",\r\n    \"negative_prompt\": \"\",\r\n    // \"voice_list\": [\r\n    //     {\r\n    //         \"voiceId\": \"\"\r\n    //     }\r\n    // ],\r\n    // \"sound\": \"\",\r\n    \"cfg_scale\": 0.5,\r\n    \"mode\": \"std\",\r\n    \"static_mask\": \"\",\r\n    \"dynamic_masks\": [\r\n        {\r\n            \"mask\": \"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\",\r\n            \"trajectories\": [\r\n                {\r\n                    \"x\": 0,\r\n                    \"y\": 0\r\n                },\r\n                {\r\n                    \"x\": 1,\r\n                    \"y\": 1\r\n                }\r\n            ],\r\n        }\r\n    ],\r\n    // \"camera_control\": {\r\n    //     \"type\": \"simple\",\r\n    //     \"config\": {\r\n    //         \"horizontal\": 1.0,\r\n    //         \"vertical\": 0,\r\n    //         \"pan\": 0,\r\n    //         \"tilt\": 0,\r\n    //         \"roll\": 0,\r\n    //         \"zoom\": 0\r\n    //     }\r\n    // },\r\n    \"duration\": 5,\r\n    \"callback_url\": \"\",\r\n    \"external_task_id\": \"\"\r\n}"
    }
  ],
  "oasExtensions": ""
}

[
  {
    "id": 162200450,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]