Kling
视频生音效
DeerAPI 视频生音效接入说明：说明 video-to-audio 的视频来源、查询方式和 callback 用法。
POST
/
kling
/
v1
/
audio
/
video-to-audio
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/audio/video-to-audio \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"video_url": "https://example.com/source-video.mp4",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}/kling/v1/audio/video-to-audio 适合根据一段视频动作和场景生成音效。它适用于环境声、动作声和氛围补声，不适合做角色对白或解说。
按字段语义，
video_id 和 video_url 只能二选一。第一次接入优先用 video_url 排错最直接；如果视频来自 Kling 上游任务，再切到 video_id。快速上手
- 首个请求准备一种视频来源，并显式带上
external_task_id和callback_url。 - 外部视频按当前字段说明需满足：
MP4或MOV、3 到 20 秒、文件不超过 100MB，分辨率为 720p 或 1080p。 - 如果视频来自其他 Kling 任务，等最终产物可用后再取
video_id，不要直接复用上游task_id。 - 即使已经使用回调，也建议业务侧保留
task_id以便异常时补查。
常见误解
- 同时传
video_id和video_url。 - 把这页当成口播或对白生成接口。
- 没有保存
external_task_id，导致后续对账和排障困难。
相关页面
- 文生音效：只有文字描述，没有视频素材时先走这里。
- 查询任务：需要补查通用音频异步任务状态时使用。
- Callback 协议：更推荐把异步结果直接回推到你的服务端。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Body
application/json
当前页面不使用 model_name；video_id 和 video_url 是互斥输入，只应保留一种。
自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性
本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
通过可灵AI生成的视频的ID ● 与input·video_url参数二选一填写，不能同时为空，也不能同时有值 ● 仅支持30天内生成并且长度在3.0秒-20.0秒的视频
所上传视频的获取链接 ● 与input·video_id参数二选一填写，不能同时为空，也不能同时有值 ● 视频格式仅支持MP4/MOV，文件大小≤100M, 分辨率支持720p或者1080p, 视频长度在3.0秒-20.0秒
⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/audio/video-to-audio \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"video_url": "https://example.com/source-video.mp4",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}