视频生音效

方法: POST路径: /kling/v1/audio/video-to-audio

本文档不实时更新，完整版请查看官方文档：https://app.klingai.com/cn/dev/document-api/apiReference/model/videoToAudio

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

video_id
string
可选
通过可灵AI生成的视频的ID  与video_url参数二选一填写，不能同时为空，也不能同时有值 仅支持30天内生成并且长度在3.0秒-20.0秒的视频
video_url
string
可选
所上传视频的获取链接  与video_id参数二选一填写，不能同时为空，也不能同时有值 视频格式仅支持MP4/MOV，文件大小≤100M, 分辨率支持720p或者1080p, 视频长度在3.0秒-20.0秒
示例
{
"video_id"
:
"二选一:通过可灵AI生成的视频的ID"
,
"video_url"
:
"二选一: 上传视频链接"
}

请求示例代码

Shell

curl --location --request POST '/kling/v1/audio/video-to-audio' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_id": "二选一:通过可灵AI生成的视频的ID",
    "video_url": "二选一: 上传视频链接"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

code
integer
必需
错误码；具体定义错误码
message
string
错误信息
必需
request_id
string
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object
必需
task_id
string
必需
任务ID，系统生成
task_status
enum<string>
必需
任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
枚举值:
submitted（已提交
processing（处理中）
succeed（成功）
failed（失败）
created_at
integer
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer
必需
任务更新时间，Unix时间戳、单位ms

示例

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