视频生音效

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配可灵 AI 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

创建任务

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	否		本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知 - 具体通知的消息 schema 见 Callback 协议

请求示例

curl --request POST \
  --url https://platform.shuyanai.com/kling/v1/audio/video-to-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "video_url": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov",
    "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
  }
}

查询任务（单个）

GET https://platform.shuyanai.com/kling/v1/audio/video-to-audio/{id}

请求头

参数	类型	必填	默认值	说明
`Content-Type`	string	是	application/json	数据交换格式
`Authorization`	string	是		鉴权信息，参考接口鉴权

请求示例

curl --request GET \
  --url https://platform.shuyanai.com/kling/v1/audio/video-to-audio/{task_id} \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "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	是		鉴权信息，参考接口鉴权

请求示例

curl --request GET \
  --url 'https://platform.shuyanai.com/kling/v1/audio/video-to-audio?pageNum=1&pageSize=30' \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "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
    }
  ]
}

11-视频配音效

视频生音效#

创建任务#

请求头#

请求体#

请求示例#

响应示例#

查询任务（单个）#

请求头#

请求示例#

响应示例#

查询任务（列表）#

请求头#

请求示例#

响应示例#

视频生音效

创建任务

请求头

请求体

请求示例

响应示例

查询任务（单个）

请求头

请求示例

响应示例

查询任务（列表）

请求头

请求示例

响应示例