11-视频配音效
视频配音效
创建任务
POST https://platform.shuyanai.com/kling/v1/audio/video-to-audio请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
video_id | string | 否 | 通过可灵 AI 生成的视频的 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 | 否 | 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知 |
请求示例
响应示例
{
"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 https://platform.shuyanai.com/kling/v1/audio/video-to-audio/{task_id}请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求示例
响应示例
{
"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
}
}查询任务（列表）
GET https://platform.shuyanai.com/kling/v1/audio/video-to-audio请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求示例
响应示例
{
"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（秒）
}
]
},
"created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
}
]
}