MaaS_KeLing_O3接口文档

请求协议

http

参数名	类型	描述
anthorization	string	鉴权

视频生成

创建视频生成任务接口

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/videos/omni-video

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`multi_shot`	boolean	可选	`false`	是否生成多镜头视频 ● 当前参数为 `true` 时，`prompt` 参数无效 ● 当前参数为 `false` 时，`shot_type` 参数及 `multi_prompt` 参数无效
`shot_type`	string	可选	空	分镜方式 ● 枚举值：`customize` ● 当 `multi_shot` 参数为 `true` 时，当前参数必填
`prompt`	string	可选	空	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：通过 `<<<>>>` 的格式来指定某个主体、图片、视频，如：`<<<element_1>>>`、`<<<image_1>>>`、`<<<video_1>>>` ● 长度不能超过2500个字符 ● 当 `multi_shot` 参数为 `false` 或 `shot_type` 参数为 `intelligence` 时，当前参数不得为空不同模型版本支持能力范围不同，详见上文能力地图
`multi_prompt`	array	可选	空	各分镜信息，如提示词、时长等 ● 通过 `index`、`prompt`、`duration` 参数定义分镜序号及相应提示词和时长，其中： ○ 最多支持6个分镜，最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长，不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 当 `multi_shot` 参数为 `true` 且 `shot_type` 参数为 `customize` 时，当前参数不得为空
`image_list`	array	可选	空	参考图列表 ● 包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频；当作为首帧或尾帧生成视频时： ○ 通过 `type` 参数来定义图片是否为首尾帧：`first_frame` 为首帧，`end_frame` 为尾帧 ■ 暂时不支持仅尾帧，即有尾帧图时必须有首帧图 ○ 使用首帧或首尾帧生成视频时，不能使用视频编辑功能； ● 支持传入图片 Base64 编码或图片 URL（确保可访问） ● 图片格式支持 `.jpg` / `.jpeg` / `.png` ● 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间 ● 参考图片数量与有无参考视频、参考主体数量有关，其中： ○ 有参考视频时，参考图片数量和参考主体数量之和不得超过4； ○ 无参考视频时，参考图片数量和参考主体数量之和不得超过7； ○ 参考图片数量超过2时，不支持设置尾帧； ● `image_url` 参数值不得为空用key:value承载，如下： `"image_list":[ { "image_url":"image_url", "type":"first_frame" }, { "image_url":"image_url", "type":"end_frame" } ]` 不同模型版本支持能力范围不同，详见上文能力地图
`element_list`	array	可选	空	参考主体列表 ● 基于主体库中主体的 ID 配置，用key:value承载，如下： `"element_list":[ { "element_id":long }, { "element_id":long } ]` ● 参考主体数量与有无参考视频、参考图片数量有关，其中： ○ 如果使用首帧生视频或首尾帧生视频时，最多支持3个主体； ○ 有参考视频时，参考图片数量和参考主体数量之和不得超过4，且不支持使用视频角色主体； ○ 无参考视频时，参考图片数量和参考主体数量之和不得超过7 ● 主体分为视频定制主体（简称：视频角色主体）和图片定制主体（简称：多图主体），适用范围不同，请注意区分不同模型版本支持能力范围不同，详见上文能力地图
`video_list`	array	可选	空	参考视频，通过 URL 方式获取 ● 可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声 ○ 通过 `refer_type` 参数区分参考视频类型：`feature` 为特征参考视频，`base` 为待编辑视频 ○ 参考视频为待编辑视频时，不能定义视频首尾帧 ○ 通过 `keep_original_sound` 参数选择是否保留视频原声，`yes` 为保留，`no` 为不保留；当前参数对特征参考视频（`feature`）也生效 ● 有参考视频时，`sound` 参数值只能为 `off` ● 用key:value承载，如下： `"video_list":[ { "video_url":"video_url", "refer_type":"base", "keep_original_sound":"yes" } ]` ● 视频格式仅支持 MP4/MOV ● 视频时长不少于3秒，上限与模型版本有关，详见能力地图 ● 视频宽高尺寸需介于720px（含）和2160px（含）之间 ● 视频帧率基于24fps～60fps，生成视频时会输出为24fps ● 至多仅支持上传1段视频，视频大小不超过200MB ● `video_url` 参数值不得为空不同模型版本支持能力范围不同，详见上文能力地图
`sound`	string	可选	`off`	生成视频时是否同时生成声音 ● 枚举值：`on`，`off` 仅 V2.6 及后续版本模型支持当前参数
`mode`	string	可选	`pro`	生成视频的模式 ● 枚举值：`std`，`pro` ● 其中 `std`：标准模式（标准），基础模式，生成720P视频，性价比高 ● 其中 `pro`：专家模式（高品质），高表现模式，生成1080P视频，视频质量更佳不同模型版本支持能力范围不同，详见上文能力地图
`aspect_ratio`	string	可选	空	生成视频的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1` ● 未使用首帧参考或视频编辑功能时，当前参数必填
`duration`	string	可选	`5`	生成视频时长，单位 s ● 枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15，其中： ○ 使用视频编辑功能（`"refer_type":"base"`）时，输出结果与传入视频时长相同，此时当前参数无效；此时，按输入视频时长四舍五入取整计量计费不同模型版本支持能力范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 ● 通过 `enabled` 参数定义 ● 用key:value承载，如下：： `"watermark_info": { "enabled": boolean // true 为生成，false 为不生成 }` ● 暂不支持自定义水印
`external_task_id`	string	可选	空	自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性

请求示例

curl --location --request POST 'https://genaiapi.cloudsway.net/v1/ai/{Your endpoint}/kling/videos/omni-video' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "multi_shot": true,
    "shot_type": "customize",
    "prompt": "",
    "multi_prompt": [
      {
        "index": 1,
        "prompt": "A person sitting on a park bench, sunlight filtering through trees.  Simple composition, no dialogue.",
        "duration": "2"
      },
      {
        "index": 2,
        "prompt": "A car speeding down a rainy street, headlights glowing.  Dynamic angle, focus on motion.",
        "duration": "3"
      }
    ],
    "image_list": [],
    "video_list": [],
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "duration": 5,  
    "external_task_id": "kling-v3-omni-video-test001"
  }'

返回值示例


{
  "code": 0, //错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
        "task_id": "string", //任务ID，系统生成
        "task_info":{ //任务创建时的参数信息
            "external_task_id": "string"//客户自定义任务ID
        }, 
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

查询视频任务接口

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/videos/omni-video/{id}

请求方法

GET

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868616892989575248",
        "task_status": "succeed",
        "created_at": 1775122924191,
        "updated_at": 1775123026539,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "videos": [
                {
                    "id": "868616893207679062",
                    "url": "{一个视频的链接}",
                    "duration": "5.041",
                    "watermark_url": null
                }
            ]
        },
        "final_unit_deduction": "5"
    },
    "request_id": "7eee6cf0-4870-469c-ba6e-48df0fa5c396"
}

图片生成

创建图片生成任务接口

请求方法

POST

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/images/omni-image

请求参数

字段	类型	必填	默认值	描述
`prompt`	string	必须	无	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的图像生成需求 ● 不能超过2500个字符 Omni模型可通过Prompt与图片等内容实现多种能力：通过<<<>>>的格式来指定某个图片，如：<<\>>
`image_list`	array	可选	空	参考图列表 • 用 key:value 承载，如下： "image_list":[ { "image":"image_url" } ] • 支持传入图片 Base64 编码或图片 URL（确保可访问） • 图片格式支持 .jpg / .jpeg / .png • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 \~ 2.5:1 之间 • 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10 • image_url 参数值不得为空 ▾隐藏子属性`image` string 必填:图片 URL 或 Base64 字符串
`element_list`	array	可选	空	主体参考列表，基于主体库中主体的 ID 配置 • 用 key:value 承载，如下： "element_list":[ { "element_id": 829836802793406551 } ] • 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10 ▾隐藏子属性`element_id` long 必填:主体库中主体的 ID
`resolution`	string	可选	`1k`	生成图片的清晰度 ● 枚举值：`1k`, `2k`, `4k` ○ `1k`：1K标清 ○ `2k`：2K高清 ○ `4k`：4K高清不同模型版本支持能力范围不同，详见上文能力地图
`result_type`	string	可选	`single`	生成结果单图/组图切换开关 ● 枚举值：`single`, `series` 不同模型版本支持范围不同，详见上文能力地图
`n`	int	可选	`1`	生成图片数量 ● 取值范围：[1,9] ● 当 result_type 值为 series 时，当前参数无效
`series_amount`	int	可选	`4`	生成组图的图片数量 ● 取值范围：[2, 9] ● 当 result_type 值为 single 时，当前参数无效不同模型版本支持范围不同，详见上文能力地图
`aspect_ratio`	string	可选	`auto`	生成图片的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`, `21:9`, `auto` ○ 其中：auto 为根据传入内容智能生成视频 ○ 参考原图横纵比生成新图时，当前参数无效不同模型版本支持范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 • 通过enabled参数定义，具体格式如下： "watermark_info": { "enabled": boolean } • true 为生成，false 为不生成 • 暂不支持自定义水印
`callback_url`	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
`external_task_id`	string	可选	无	自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性

请求示例1（引入图片）

curl --location --request POST 'https://genaiapi.cloudsway.net/v1/ai/{Your endpoint}/kling/images/omni-image' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "将所有图片中的人物融合到<<<object_1>>>图中",
    "element_list": [
        {
            "element_id": 829836802793406551
        }
    ],
    "image_list": [
        {
            "image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png"
        },
        {
            "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/1.png"
        },
        {
            "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/4.png"
        }
    ],
    "resolution": "2k",
    "n": 1,
    "aspect_ratio": "3:2"
  }'

请求示例2（引入图片+主体）

curl --location --request POST 'https://genaiapi.cloudsway.net/v1/ai/{Your endpoint}/kling/images/omni-image' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Generate a recommended cover for each subject <<element_1>> based on the style of the reference image <<image_1>>",
    "element_list": [
      {
        "element_id": "160"
      },
      {
        "element_id": "161"
      }
    ],
    "image_list": [
      {
        "image": "xxx"
      },
      {
        "image": "xxx"
      }
    ],
    "resolution": "2k",
    "result_type": "series",
    "series_amount": 2,
    "aspect_ratio": "auto",
    "external_task_id": "",
    "callback_url": ""
  }'

返回值示例

{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_info": { //任务创建时的参数信息
      "external_task_id": "string" //客户自定义任务ID
    },
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

查询图片任务接口

请求URL

GET

请求方法

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/images/omni-image/{id}

返回值示例

{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
    "task_info": { //任务创建时的参数信息
      "external_task_id": "string" //客户自定义任务ID
    },
    "task_result": {
      "result_type": "single",
      "images": [
        {
          "index": 0, // 图片编号
          "url": "string", // 生成图片的URL，防盗链格式（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
          "watermark_url": "string" // 含水印图片下载URL，防盗链格式
        }
      ],
      "series_images": [
        {
          "index": 0, // 组图序号
          "url": "string", // 生成图片的URL，防盗链格式（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
          "watermark_url": "string" // 含水印图片下载URL，防盗链格式
        }
      ]
    },
    "watermark_info": { "enabled": boolean }, // 是否含水印
    "final_unit_deduction": "string", // 任务最终扣减积分数值
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

视频生音效

创建任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
video_id	string	可选	空	通过MaaS_KeLing生成的视频的 ID 与 video_url 参数二选一填写，不能同时为空，也不能同时有值仅支持 30 天内生成并且长度在 3.0 秒-20.0 秒的视频
video_url	string	可选	无	所上传视频的获取链接与 video_id 参数二选一填写，不能同时为空，也不能同时有值视频格式仅支持 MP4/MOV，文件大小≤100M，视频长度在 3.0 秒-20.0 秒
sound_effect_prompt	string	可选	无	音效生成提示词不能超过 200 个字符
bgm_prompt	string	可选	无	配乐生成提示词 • 不能超过 200 个字符
asmr_mode	boolean	可选	false	是否开启 ASMR 模式；该模式会增强细节音效，适合高沉浸内容场景 • true 表示开启，false 表示关闭（默认值）
external_task_id	string	可选	无	自定义任务 ID 用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询请注意，单用户下需要保证唯一性
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

请求示例

curl -g 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
    "video_id": "",
    "video_url": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov"
}'

返回示例

{
  "code": 0, // 错误码；
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_info": { // 任务创建时的参数信息
      "external_task_id": "string" // 客户自定义任务ID
    },
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
  }
}

查询视频生音效任务

请求方法

GET

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio/{taskId或external\_task\_id}

task_id

视频生音频的任务ID。直接在请求路径中填写值，与external_task_id两种查询方式二选一

external_task_id

视频生音频的自定义任务ID。创建任务时填写的 external_task_id，与 task_id 两种查询方式二选一

请求示例

curl -g 'https://genaiapi.cloudsway.net/v1/ai/{{endpointPath}}/kling/audio/video-to-audio/{{taskId}}' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json'

返回示例

{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
    "task_info": { // 任务创建时的参数信息
      "external_task_id": "string", // 客户自定义任务ID
      "parent_video": { // 原始视频信息
        "id": "string", // 原始视频ID
        "url": "string", // 原始视频URL
        "duration": "string" // 原始视频时长，单位s（秒）
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "string", // 生成的视频ID；全局唯一
          "url": "string", // 生成视频的URL（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
          "duration": "string" // 视频总时长，单位s（秒）
        }
      ],
      "audios": [
        {
          "id": "string", // 生成的音频ID；全局唯一，将在30天后被清理
          "url_mp3": "string", // 生成音频的MP3格式URL（请注意，为保障信息安全，生成的音频会在30天后被清理，请及时转存）
          "url_wav": "string", // 生成音频的WAV格式URL（请注意，为保障信息安全，生成的音频会在30天后被清理，请及时转存）
          "duration_mp3": "string", // MP3格式音频总时长，单位s（秒）
          "duration_wav": "string" // WAV格式音频总时长，单位s（秒）
        }
      ]
    },
    "final_unit_deduction": "string", // 任务最终扣减积分数值
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
  }
}

文生音效

创建文生音效任务

请求URL

POST v1/ai/{endpointPath}/kling/audio/text-to-audio

请求参数

请求示例

curl -g 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/audio/text-to-audio' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
    "prompt": "春节庆祝时的烟花声",
    "duration": 3,
    "external_task_id": "",
    "callback_url": ""
  }'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "871457979416604766",
        "task_status": "submitted",
        "created_at": 1775800291981,
        "updated_at": 1775800291981,
        "task_info": {}
    },
    "request_id": "828f9782-d2e1-4550-a36d-e715ae2ae037"
}

查询文生音效任务

请求URL

GET v1/ai/{endpointPath}/kling/audio/text-to-audio/{id}

task_id

文生音频的任务 ID:请求路径参数，直接将值填写在请求路径中,与 external_task_id 两种查询方式二选一

external_task_id

用户自定义任务ID。创建任务时填写的 external_task_id，与 task_id 两种查询方式二选一

请求示例

curl -g 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/audio/text-to-audio/{id}' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "871457647223545935",
        "task_status": "succeed",
        "created_at": 1775800212780,
        "updated_at": 1775800228263,
        "task_status_msg": "",
        "task_info": {},
        "task_result": {
            "audios": [
                {
                    "id": "871457647265472604",
                    "url": null,
                    "duration": null,
                    "url_mp3": "https://v1-fdl.kechuangai.com/ksc2/ErHLIqeozb1WHdz1Izp1XGMBtJebQoG3Cp-2dvW1aWViY8RLKpP-tk5x7W6eeTn2b9GYO9YFP-o6znENuMnJ_gfCTlDfVz_FxCmXqGQ_q9-dhYwdNq2aZ8d7OHlPbYDwz0EsdeQnxcY_WktB6fbeiN5oHMdZZX8Uptz-fQGeBJWReQzcvLau7vxSQFcBf1rU1kGJZD3nRhuRJ-QT0NE0SA.mp3?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAFXEmxe-C5r1GsrJ4R_tFpMHnPrbjCJDG0KIp-dlRASzaKKVZPnTgDc4lOQw0tb7j0a6SuaZpiXsbq5v7GDhAdOjAaaMEFTIEhrKwILiBTZGoMM-l7cRD7Ak1Ijpt7KdddfiPC78jYKpRJEQVhp4DUtiyq8gzSrs6IOPskVBlbkMrhYZjRCYaJlswSacwFokyXfVoigHmoCox4tWOKtHuxwm5f_cNbqIxHkA6_Z19xqBhoSj4dfrTYhUzYe6jlYP2ZR__D3IiDmgbsrWNwPG28XCgRF7KfT3EKY6rUhktnmmeKY_OffqCgFMAE&x-kcdn-pid=112757&pkey=AAXEF3UtKZpRO5SOnZyIm1g87c3z1b0907OuSWpmsuDt4YCj95yjTniBUsV4LWeF5xlebOHfqK04MbbxPGXsyKVxpOqoVRq45ysb_TG_D6tKUSyb4zwibeQsYkSxRnmsFQw",
                    "url_wav": "https://v1-fdl.kechuangai.com/ksc2/ax60xYdmxPhWhrgqKcjG_R9nmqBtwZMYjs5jpC56Q5hVdN5Oae3O7d7kzmoEMhSJ-9Xv7-jrsi3v2DL0aHod0XOhTY8qoSofHRwh02DrXweWPL3JnQlUb13iVF2821muQ1O_-1-cbKUP1pg-QpQUOHvhd_FydZUe36F6bnvEW3E9AvbB95J6K0py-whjEerp2Z59LoNZAo2cHPtKS0ncHQ.wav?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHMhoi-CYC9uUILiob74ZeXGkx3LSdWf7QCCBzpAdPiIjTaWxyhiErxhtb1mMQxCeT-YmlFsuqdVOJ73bXn5w7A6kLgO27kbl4uM5IjmZV5_dwTGhllwW_B2UXMdfwFxKIfRPu93U3-2M-Y3chNNOd0GhtUteZ9KIQn9Xc9bSpncu6HeNoMhIVm76XCDYyldt54EFfx8yLB51QV6LFCnnOtiAzbD-srIaG7HPJtH5j5tRoSqwnSbF-azU9cbKSOb8doGVG2IiAf7HRWbkMraGIU3pE62uCrWJoBkKaBwUWwUTOYw9nlhCgFMAE&x-kcdn-pid=112757&pkey=AAVm6lQUh6-ZOYrSRgFdt0zru0pJpiVxoeU820BANf98nNF4I4T8nG-q9lNdkw01UgQWYSR7L3cr6v6MVHiyN3UfBhNJJ9SFSS9f4E4z1eAlaLm8L8p3Ew6-nhILspq7oQU",
                    "duration_mp3": "3.056",
                    "duration_wav": "3.0"
                }
            ]
        },
        "final_unit_deduction": "0.25"
    },
    "request_id": "5571ddf9-0c33-44cd-8087-300bb47688ab"
}

数字人

创建任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/videos/avatar/image2video

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
image	string	必须	无	数字人参考图支持传入图片Base64编码或图片URL（确保可访问）请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。示例：正确的Base64编码参数： `1 iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 错误的Base64编码参数（包含data:前缀）： `1 data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
audio_id	string	可选	空	通过试听接口生成的音频的ID 仅支持使用30天内生成的、时长不短于2秒且不超过300秒的音频 audio_id、sound_file参数二选一，不能同时为空，也不能同时有值
sound_file	string	可选	空	音频文件支持传入音频Base64编码或图音频URL（确保可访问）音频文件支持.mp3/.wav/.m4a/.aac(标准audio/acc格式)，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息仅支持使用时长不短于2秒且不长于300秒的音频 audio_id、sound_file参数二选一，不能同时为空，也不能同时有值系统会校验音频内容，如有问题会返回错误码等信息
prompt	string	可选	空	正向文本提示词可定义数字人动作、情绪及运镜等不能超过2500个字符
mode	string	可选	std	生成视频的模式枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知具体通知的消息schema见“Callback协议”
external_task_id	string	可选	空	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

请求示例

curl --location --request POST 'https://genaiapi.cloudsway.net/v1/ai/{Your endpoint}/kling/videos/avatar/image2video' \
--header 'Authorization: Bearer {YOUR_AK}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "一个古风女孩在唱古风歌曲",
    "image": "https://p4-fdl.klingai.com/ksc2/TYBZGeCy2X-AlFG2BzHJ99DxeGPQbOjXamDu3v9Ecq_e1eVlu7H6D_7IaorVJr3aH2UyymnOb_3CRnbu2QnLT3C1hFoLUFPb3j6cJSPP_PIcVEtEEDaSrmRLy50znof-z86Vbg9peLFFbQd9aXFM4h3q3DjVzXP22cgxCkJKzJ-GxXn9qQOm8P_Qd-rVy_CbUL6j_X5lriXPkG9YE1WUaQ.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAEAMvnTk2zeXWfHeE0x9-pJh5qSzTyipQE_qi7aNWPgsddpyhPpG1XOFZN8VC6pYGtcInKWCqBjsY_Zl1MnQaGffyadf_kRG2g781a0d3ikEVHJeZiCt0gJrQCv6mWm8HgW53FZ1UXtupVe1FJnkLMa5JCneEIJbHkXnms2Y2UwuMl4n9fzbdM6MhKVFmIkwu2saYsguXLHUBAkSspuTQa2_S00cGfMA68qPJQeFlgp5BoSiLisQ3JW5QwpPz64VCCZ6-c0IiAUG1fwWBGOMfuSHLam2QirUp0YC0HTBFqFSZnYSqQIgSgFMAE&x-kcdn-pid=112757&pkey=AAX9eJQ7p7gVFmiSYauqc3rcObOQZTQe4Z-HxAnAq7xbot2_iV48hlKJKUvAsvHQVak75dca3mJ5SippG1VL4HWbOJmksckSyffvVHVKk-p-q19Vkc1JZ9sK2aaYeDFVLBI",
    "sound_file":"https://cdn.mureka.ai/cos-prod/open/song/20251229/113366463152129-9DDrRrRu26n4iifY3Rgbyb.mp3"
}'

返回值示例

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
    "task_id": "string", //任务ID，系统生成
    "task_info":{ //任务创建时的参数信息
       "external_task_id": "string" //客户自定义任务ID
    }, 
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

查询任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/videos/avatar/image2video/{task_id}

请求方法

GET

请求参数

字段	类型	必填	默认值	描述
task_id	string	可选	无	数字人的任务ID 请求路径参数，直接将值填写在请求路径中

返回值示例

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
          "task_id": "string", //任务ID，系统生成
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "task_status_msg": "string", //任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
    "task_info": { //任务创建时的参数信息
      "external_task_id": "string"//客户自定义任务ID
    },
    "task_result":{
      "videos":[
        {
                "id": "string", //生成的视频ID；全局唯一
                      "url": "string", //生成视频的URL，例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.mp4（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
                      "duration": "string" //视频总时长，单位s
        }
      ]
    },
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

MaaS_KeLing_O3接口文档

请求协议

请求Header

视频生成

创建视频生成任务接口

请求URL

请求方法

请求参数

请求示例

返回值示例

查询视频任务接口

请求URL

请求方法

返回值示例

图片生成

创建图片生成任务接口

请求方法

请求URL

请求参数

请求示例1（引入图片）

请求示例2（引入图片+主体）

返回值示例

查询图片任务接口

请求URL

请求方法

返回值示例

视频生音效

创建任务

请求URL

请求方法

请求参数

请求示例

返回示例

查询视频生音效任务

请求方法

请求URL

请求示例

返回示例

文生音效

创建文生音效任务

请求URL

请求参数

请求示例

返回示例

查询文生音效任务

请求URL

请求示例

返回示例

数字人

创建任务

请求URL

请求方法

请求参数

请求示例

返回值示例

查询任务

请求URL

请求方法

请求参数

返回值示例