MaaS_KL_v3

能力地图

功能分类	子功能	3std (3\~15s)	pro (3\~15s)	4k (3s\~15s)
文生视频	单镜头视频生成	✓	✓	✓
	多镜头视频生成	✓	✓	✓
	声音控制 (人声控制)	✗	✗	✗
图生视频	单镜头视频生成 (仅首帧)	✓	✓	✓
	多镜头视频生成	✓	✓	✓
	首尾帧 (一镜到底)	✓	✓	✓
	主体控制 (视频角色主体+多图主体)	✓	✓	✓
	动作控制	✓	✓	✗
	声音控制 (人声控制)	✗	✗	✗

请求协议

http

参数名	类型	描述
anthorization	string	鉴权

文生视频

创建任务

POST

https://genaiapi.cloudsway.net/v1/ai/{endpoinPath}/kling/videos/text2video

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`model_name`	string	可选	`kling-v1`	模型名称● 枚举值：, MaaS_KeLing_V2.1_master, MaaS_KeLing_V2.5_turbo, MaaS_KeLing_V2.6, MaaS_KeLing_3.0_video
`multi_shot`	boolean	可选	`false`	是否生成多镜头视频 ● 当前参数为 true 时，prompt 参数无效 ● 当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效
`shot_type`	string	可选	空	分镜方式 ● 枚举值：`customize`, `intelligence` ● 当 multi_shot 参数为 true 且 shot_type 参数为 customize 时，当前参数必须填写
`prompt`	string	可选	空	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求 ● 不能超过2500个字符Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力： 1. 通过 `<<<>>>` 的格式来指定某个主体、图片、视频，如：`<<<element_1>>>`、`<<<image_1>>>`、`<<<video_1>>>` ● 当 multi_shot 参数为 false 或 shot_type 参数为 intelligence 时，当前参数必须填写
`multi_prompt`	array	可选	空	各分镜提示词，可包含正向描述和负向描述 ● 通过 index、prompt、duration 参数定义分镜序号及相应提示词和时长，其中： ○ 最多支持6个分镜，最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长，不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 用 key:value 承载，如下： "multi_prompt":[ { "index":int, "prompt": "string", "duration": "5" }, { "index":int, "prompt": "string", "duration": "5" } ] ● 当 multi_shot 参数为 true 且 shot_type 参数为 customize 时，当前参数不得为空
`negative_prompt`	string	可选	空	负向文本提示词 ● 建议将负向提示词用否定描述的方式写入正向提示词中 ● 不能超过2500个字符
`sound`	string	可选	`off`	生成视频时是否同时生成声音 ● 枚举值：`on`, `off` 仅V2.6及以上版本模型支持当前参数
`mode`	string	可选	`std`	生成视频的模式枚举值：std，pro，4k。其中： std：标准模式（标准），基础模式，性价比高，输出视频分辨率为720P pro：专家模式（高品质），高表现模式，生成视频质量更佳，输出视频分辨率为1080P。 4k：4K模式，高表现（同pro），生成视频质量更佳，输出视频分辨率为4K。不同模型版本支持能力范围不同，详见上文能力地图
`aspect_ratio`	string	可选	`16:9`	生成视频的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1`
`duration`	string	可选	`5`	生成视频时长，单位s ● 枚举值：3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 不同模型版本支持能力范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 ● 通过 enabled 参数定义，用 key:value 承载，如下： "watermark_info": { "enabled": boolean // true 为生成，false 为不生成 } ● 暂不支持自定义水印
`external_task_id`	string	可选	无	自定义任务ID● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询● 请注意，单用户下需要保证唯一性

请求示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/videos/text2video' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-v3",
    "prompt": "Epic BBC natural history documentary style, 4K ultra-high-definition quality. In the twilight of the African savannah, dust swirls as a brutal struggle for survival unfolds. A massive lion with a disheveled mane unleashes a thunderous roar, its powerful muscles rippling in the golden sunset light as it swings its claws to fend off attackers. Surrounding it are a dozen cunning, relentless spotted hyenas — snarling, eyes gleaming with greed — employing encirclement tactics as they dart, feint, and bite with fluid agility. The scene pulses with raw, untamed tension, capturing flying saliva, drifting dust, the authentic texture of animal fur, and dramatically dramatic lighting and shadow.",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "duration": "5"
}'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868602593017598033",
        "task_status": "processing",
        "created_at": 1775119514814,
        "updated_at": 1775119524744,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {}
    },
    "request_id": "ea45fa79-c2bf-4545-922f-5647c5d5218d"
}

查询任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/videos/text2video/{taskid}

请求方法

GET

查询示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/videos/text2video/788832073707958348' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868890153925369900",
        "task_status": "succeed",
        "created_at": 1775188074674,
        "updated_at": 1775188152228,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "videos": [
                {
                    "id": "868890154063794228",
                    "url": "https://v1-fdl.kechuangai.com/ksc2/ZAonwibnVSsBTR4-QxHkB_YKEZYFgoXG7A1Yc_QAHKLPUhcyhqnHwDkXz8SOypZVFWUWmkMV5vgE2_RPLamgd8hbrpSyZMvLD9HNIJgllXd_Os1Pm8FAbZC9U5Vx1oXBagSCUo74dn4qUUxeBY51PsuY9saFYEzqVbF6-Nj7JYEMmaWse-t0Y3HhguP8F94apKw3etnebmgbbPvwnfcLdQ.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAGNmVFX1dR7C1hY15zrRNFzFjI5aofE-lzF1oDvKvIqM0OhWaD0ipqFMqaI75q8h6ZGomvHttKNOSHbzyUUB783SkDz5C93U9DthHmAe5p-Mk4eO1Ho_-IpPzNHi3CpO0AmA49If-ezk1EojNt60UydPG4UAv-IhaRExr7NmggcQ8H_9hLSwdk2zK3Bl6uvHlXlKigQjXqhqgGHT_satElXetMR4TdWgIPaPZHO09C3wxoSoUWhYgsuBTfVWszBdm10UXP1IiARoGmF2lj1HtncEsVuFUSywo_hctF_p02rvkGmfCq8jigFMAE&x-kcdn-pid=112757&pkey=AAWwW6x4NpkyPyk7rDNAIf_3OgO5G5fpH2EiRAc872uEP3bKL9mQuD0FnoccREcZbsFtOnoVDKY9uwMKewzhSWEsHKlXFWU4NCVCRhypHV4zgbVqnmADqeW_tca0ihiVWs0",
                    "duration": "5.041",
                    "watermark_url": null
                }
            ]
        },
        "final_unit_deduction": "6"
    },
    "request_id": "21ff9a73-562f-4b7e-9f9a-4e12994cc080"
}

图生视频

创建任务

请求URL

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

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`model_name`	string	可选	`kling-v1`	模型名称 ● 枚举值：`kling-v1`, `kling-v1-5`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1-master`, `kling-v2-5-turbo`, `kling-v2-6`, `kling-v3`
`image`	string	可选	空	参考图片 ● 支持传入图片 Base64 编码或图片 URL（确保可访问） ● 图片格式支持 .jpg / .jpeg / .png ● 图片文件大小不能超过 10MB ● 图片宽高尺寸不小于 300px ● 图片宽高比要在 1:2.5 ~ 2.5:1 之间 ● image 参数与 image_tail 参数二选一，二者不能同时为空 ● 不同模型版本支持能力范围不同，详见上文能力地图
`image_tail`	string	可选	空	参考图片：尾帧图 ● 支持传入图片 Base64 编码或图片 URL（确保可访问） ● 图片格式支持 .jpg / .jpeg / .png ● 图片文件大小不能超过 10MB ● 图片宽高尺寸不小于 300px ● 图片宽高比要在 1:2.5 ~ 2.5:1 之间 ● image 参数与 image_tail 参数二选一，二者不能同时为空 ● 不同模型版本支持能力范围不同，详见上文能力地图
`multi_shot`	boolean	可选	`false`	是否生成多镜头视频 ● 当前参数为 true 时，prompt 参数无效 ● 当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效
`shot_type`	string	可选	空	分镜方式 ● 枚举值：`customize`, `intelligence` ● 当 multi_shot 参数为 true 且 shot_type 参数为 customize 时，当前参数必须填写
`prompt`	string	可选	空	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求 ● 不能超过2500个字符Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力： 1. 通过 `<<<>>>` 的格式来指定某个主体、图片、视频，如：`<<<element_1>>>`、`<<<image_1>>>`、`<<<video_1>>>` ● 用 `<<<voice_id>>>` 来指定音色，序号同 voice_list 参数所引用音色的排列顺序 ● 一次视频生成任务至多引用2个音色，指定音色时，sound 参数值必须为 on ● 语法结构越简单越好，如：男人 `<<<voice_id>>>` 说：“你好” ● 当 voice_list 参数不为空且 prompt 参数中引用音色ID时，视频生成任务按“有指定音色”计量计费 ● 当 multi_shot 参数为 false 或 shot_type 参数为 intelligence 时，当前参数必须填写
`multi_prompt`	array	可选	空	各分镜提示词，可包含正向描述和负向描述 ● 通过 index、prompt、duration 参数定义分镜序号及相应提示词和时长，其中： ○ 最多支持6个分镜，最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长，不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 用 key:value 承载，如下： "multi_prompt":[ { "index":int, "prompt": "string", "duration": "5" }, { "index":int, "prompt": "string", "duration": "5" } ] ● 当 multi_shot 参数为 true 且 shot_type 参数为 customize 时，当前参数不得为空
`negative_prompt`	string	可选	空	负向文本提示词 ● 建议将负向提示词用否定描述的方式写入正向提示词中 ● 不能超过2500个字符
`element_list`	array	可选	空	参考主体列表 ● 基于主体库中主体的 ID 配置，用 key:value 承载，如下： "element_list":[ { "element_id":long }, { "element_id":long } ] ● 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10
`sound`	string	可选	`off`	生成视频时是否同时生成声音 ● 枚举值：`on`, `off` 仅V2.6及以上版本模型支持当前参数
`mode`	string	可选	`std`	生成视频的模式枚举值：std，pro，4k。其中： std：标准模式（标准），基础模式，性价比高，输出视频分辨率为720P pro：专家模式（高品质），高表现模式，生成视频质量更佳，输出视频分辨率为1080P。 4k：4K模式，高表现（同pro），生成视频质量更佳，输出视频分辨率为4K。不同模型版本支持能力范围不同，详见上文能力地图
`aspect_ratio`	string	可选	`16:9`	生成视频的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1`
`duration`	string	可选	`5`	生成视频时长，单位s ● 枚举值：3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 不同模型版本支持能力范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 ● 通过 enabled 参数定义，用 key:value 承载，如下： "watermark_info": { "enabled": boolean // true 为生成，false 为不生成 } ● 暂不支持自定义水印
`external_task_id`	string	可选	无	自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性

请求示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/videos/image2video' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-v2.6",
    "prompt": "Hollywood blockbuster-level visual effects, 8K ultra-high resolution. In a neon-drenched, rain-soaked city nightscape, Kong and Godzilla erupt into an explosive death match. Kong roars as he hurls a massive punch, every muscle in his arm bulging with raw power, while Godzilla gapes its jaws and its dorsal fins blaze with searing atomic blue light, ready to fire. The moment of impact unleashes a staggering shockwave, shattering surrounding skyscraper windows and sending countless chunks of debris and cascading sparks flying through the air. Raindrops hitting the monsters’ skin instantly vaporize into mist. The scene is drenched in apocalyptic, earth-shattering tension and sheer destructive force.",
    "image": "https://img2.baidu.com/it/u=2688005144,1651821809&fm=253&fmt=auto&app=120&f=JPEG?w=666&h=500",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "duration": "5",
    "external_task_id": "external_task_id"
}'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868890892747673686",
        "task_status": "submitted",
        "created_at": 1775188250826,
        "updated_at": 1775188250826,
        "task_info": {
            "parent_video": null
        }
    },
    "request_id": "e9eb1aff-f64a-40bf-b9a5-b9ff45adaa8e"
}

查询任务

请求URL

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

请求方法

GET

查询示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/videos/image2video/788872612687921228' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868890892747673686",
        "task_status": "succeed",
        "created_at": 1775188250826,
        "updated_at": 1775188467595,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "videos": [
                {
                    "id": "868890892911263836",
                    "url": "https://v4-fdl.kechuangai.com/ksc2/5H8Q9rkwbJYc2hNASa3tJedZI32pLHm-wtvwWAOWVXvt-W_CvEoPdYQYy-y8Rcn019YPqfY1K69VJ1db2gmknn9rogIFtul-JsV1fAS6bSMuRhDpii2SnbwshFXZF2riJhhAoUhciWT87Xf4ZbhqehgmUmHkLOQIJJRVBWPOhjV2m-waf_If2DakIPMVUXiftr7tDbV7QJVbQHYS3GSpNw.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAE1joX4zIbPH-Cm67NtCYBec22XBXK3wJaPFIn_cCxkJjsULN77k5Oy5DWq1hZpVhhEatwts5cuQEKUosHrT-RSbWU5IlkipC0sBnjcvG3hPs8CCxGHqS2z8Q1xFCmgEQ3Hd1ebXp3WxUnxgUf3W9XnVb9wQ5-hJ6I-YwXR1cl8DHcXiAvIhghP17cxWEAyJtCch6g9zE6WRPeX3h_4dPOtWOji4Z1R9hpxBL0NawdnvhoSbgFFnrpiqTZzapT733K7iU3CIiCbrd1zxr8zitaTO1HVhGmBRZYGGvO3Zwxs9lEcZ4dM4ygFMAE&x-kcdn-pid=112757&pkey=AAXJ_qjKB4mdRvnsGFL-z-loytZSITXZvXm3x8ULgTZRHdMZBticEIOze4CgFO41M44uHnvbDPS_4qgwfKrKgGqEkIq3t0TNQgQ-hXTmLIoBgD6rh7Dajx9a2OO2OLAeShM",
                    "duration": "5.041",
                    "watermark_url": null
                }
            ]
        },
        "final_unit_deduction": "6"
    },
    "request_id": "091dc51b-589d-4d5b-9c1a-430ab0ba4cce"
}

图像生成

创建任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpoinPath}/kling/images/generations

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`model_name`	string	可选	`kling-v1`	模型名称 ● 枚举值：kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1, kling-v3
`prompt`	string	必须	无	文本提示词，可包含正向描述和负向描述 ● 不能超过2500个字符
`negative_prompt`	string	可选	空	负向文本提示词不能超过2500个字符建议将负向提示词用否定描述的方式写入正向提示词中注：图生图（即image字段不为空时）场景下，不支持负向提示词
`image`	string	可选	空	参考图片支持传入图片Base64编码或图片URL（确保可访问）请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。示例：正确的Base64编码参数： `iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 错误的Base64编码参数（包含data:前缀）： `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间 image_reference参数不为空时，当前参数必填
`element_list`	array	可选	空	主体参考列表基于主体库中主体的ID配置，用key:value承载，如下： `"element_list":[ { "element_id":long }, { "element_id":long } ]` 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过10
`resolution`	string	可选	1k	生成图片的清晰度枚举值：1k, 2k 1k：1K标清 2k：2K高清不同模型版本支持范围不同，详见官方文档能力地图
`n`	int	可选	1	生成图片数量取值范围：[1,9]
`aspect_ratio`	string	可选	16:9	生成图片的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 不同模型版本支持范围不同，详见官方文档能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果通过enabled参数定义，用key:value承载，如下： `"watermark_info": { "enabled": boolean // true 为生成，false 为不生成 }` 暂不支持自定义水印
`callback_url`	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知具体通知的消息schema见“Callback协议”
`external_task_id`	string	可选	无	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

请求示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/images/generations' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-v3",
    "prompt": "Generate images of the numbers 1 through 9",
    "element_list": [
        {
            "element_id": "160"
        },
        {
            "element_id": "161"
        },
        {
            "element_id": "159"
        }
    ],
    "image": "xxx",
    "resolution": "2k",
    "n": "9",
    "aspect_ratio": "3:2",
    "external_task_id": "",
    "callback_url": ""
}'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868892585292099640",
        "task_status": "submitted",
        "created_at": 1775188654357,
        "updated_at": 1775188654357,
        "task_info": {
            "parent_video": null
        }
    },
    "request_id": "68329d65-ee21-4013-9aa6-f0bc2cc07744"
}

查询任务（单个）

请求URL

https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/kling/images/generations/{taskId}

请求方法

GET

查询示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/${Your Endpoint}/kling/images/generations/858114895710539873' \
--header 'Authorization: Bearer ${Your AK}' \
--header 'Content-Type: application/json'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868892585292099640",
        "task_status": "failed",
        "created_at": 1775188654357,
        "updated_at": 1775188656386,
        "task_status_msg": "Image format is invalid",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "images": null,
            "result_type": null,
            "series_images": null
        },
        "final_unit_deduction": "0"
    },
    "request_id": "a699ea31-8369-4b80-a796-7ca574d5ddf8"
}

文生音效

创建文生音效任务

请求URL

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

请求参数

字段	类型	必填	默认值	描述
prompt	string	必填	无	文本提示词 • 内容长度不超过 200 字符
duration	float	必填	无	生成音频的时长 • 取值范围：3.0 秒至 10.0 秒，支持小数点后一位精度
external_task_id	string	可选	无	自定义任务 ID •用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询 •请注意，单用户下需要保证唯一性
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

请求示例

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": "The sound of fireworks during Spring Festival celebrations.",
    "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"
}

MaaS_KL_v3

能力地图

请求协议

Header

文生视频

创建任务

请求方法

请求参数

请求示例

返回值示例

查询任务

请求URL

请求方法

查询示例

返回值示例

图生视频

创建任务

请求URL

请求方法

请求参数

请求示例

返回值示例

查询任务

请求URL

请求方法

查询示例

返回值示例

图像生成

创建任务

请求URL

请求方法

请求参数

请求示例

返回值示例

查询任务（单个）

请求URL

请求方法

查询示例

返回值示例

文生音效

创建文生音效任务

请求URL

请求参数

请求示例

返回示例

查询文生音效任务

请求URL

请求示例

返回示例