AU
Kling (可灵) 音频生成 API
AI 音频生成 - 文生音效、视频配音、语音合成。
快速开始
1
从控制台获取 API 密钥2
选择 Kling 音频模型3
发送 POST 请求创建任务4
轮询 GET 请求获取音频结果认证方式
在所有请求中添加 Bearer Token 认证头:
Authorization: Bearer YOUR_API_KEY
可用模型
| 模型 | API 名称 | 特性 | 价格 (最多省60%) |
|---|---|---|---|
| 文生音效 | kling-sound-effects | 音效生成, 3-10秒 | $0.0440/次 |
| 视频配音 | kling-video-to-audio | 视频配音+背景音乐, 3-20秒视频 | $0.0440/次 |
| 语音合成 | kling-tts | 文本转语音, 多种音色 | $0.0100/次 |
定价 (最多省60%)
| 模型 | 价格 |
|---|---|
kling-sound-effects | $0.0440/次 |
kling-video-to-audio | $0.0440/次 |
kling-tts | $0.0100/次 |
接口端点
POST
/api/v1/audio/generations创建可灵音频生成任务。根据 model 参数自动路由到文生音效、视频配音或语音合成。
GET
/api/v1/audio/generations?task_id=xxx查询任务状态并获取音频链接
请求参数
文生音效 (kling-sound-effects)
model必填string
"kling-sound-effects"
prompt必填string
音效的文本描述
duration必填string
"3.0" 到 "10.0"(支持1位小数)
callback_urlstring
完成后的回调 URL
视频配音 (kling-video-to-audio)
model必填string
"kling-video-to-audio"
video_idstring
可灵视频 ID(30天内,3-20秒)。video_id 和 video_url 二选一。
video_urlstring
视频 URL(MP4/MOV,<=100MB,3-20秒)。video_id 和 video_url 二选一。
sound_effect_promptstring
音效提示词
bgm_promptstring
背景音乐提示词
asmr_modeboolean
增强细节音效
callback_urlstring
完成后的回调 URL
语音合成 (kling-tts)
model必填string
"kling-tts"
text必填string
要合成的文本(最多1000字符)
voice_id必填string
可灵音色 ID,如 "genshin_vindi2"。完整可用清单(预置 + 你的自定义音色)请调 GET /api/v1/kling/voices 获取。其它系统(如 Minimax)的 ID 在此无效。
voice_language必填string
语言代码,如 "zh"、"en"
voice_speednumber
0.8-2.0,默认 1.0
callback_urlstring
完成后的回调 URL
代码示例
curl -X POST https://api.apimodels.app/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-sound-effects",
"prompt": "Strong wind blowing through a forest with rustling leaves",
"duration": "5.0"
}'响应格式
创建任务响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "pending",
"model": "kling-audio/kling-sound-effects"
}
}成功响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "completed",
"model": "kling-audio/kling-sound-effects",
"resultUrls": ["https://...audio.mp3"],
"createTime": 1705123450000,
"completeTime": 1705123500000
}
}失败响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "failed",
"model": "kling-audio/kling-sound-effects",
"failMsg": "Content policy violation"
}
}回调通知 (callback_url)
在创建请求中传入 callback_url 后,任务进入 completed 或 failed 终态时,我们会向该地址发起一次 HTTP POST。请求头仅包含 Content-Type: application/json,无签名头。失败会自动重试 3 次(指数退避 1s/2s/4s,单次超时 10s);如果仍未成功,后台会在 30 分钟内继续补偿重发,直到接收端返回 2xx。
Payload 结构
POST {your callback_url}
Content-Type: application/json
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"model": "kling-audio/kling-sound-effects",
"state": "completed" | "failed",
"param": "<JSON string>", // request params, JSON.parse once
"resultJson": "<JSON string> | null", // result object, JSON.parse once
"failCode": null | "CONTENT_MODERATION | INVALID_INPUT | INSUFFICIENT_BALANCE | UPSTREAM_BUSY | UPSTREAM_FAILED | TIMEOUT | INTERNAL_ERROR | OTHER",
"failMsg": null | "string",
"retryable": true | false, // present when state=failed: safe to retry/fallback
"costTime": 12345, // duration in ms
"completeTime": 1705123500000, // ms epoch
"createTime": 1705123450000 // ms epoch
}
}注意:data.param 与 data.resultJson 都是 JSON 字符串,使用前必须 JSON.parse 一次。
音频任务:JSON.parse(data.resultJson) 后的结构
{
"resultUrls": ["https://r2.apimodels.app/audio/xxx.mp3"],
"audioDuration": 12.5 // optional, seconds
}resultUrls 是 R2 托管的音频 URL 数组(成功时长度通常为 1)。部分上游会带 audioDuration(秒)。state=failed 时 resultJson 通常为 null 或 {"resultUrls":[]}。
Node.js 接收示例
app.post('/webhook/kling-audio', express.json(), (req, res) => {
const { taskId, state, resultJson, failMsg } = req.body.data
if (state === 'completed') {
const r = JSON.parse(resultJson)
console.log('audio ready', taskId, r.resultUrls[0], r.audioDuration)
} else {
console.warn('audio failed', taskId, failMsg)
}
res.status(200).end() // must be 2xx, otherwise we retry
})注意事项
- -每个任务只在送达 2xx 后停止重发,已送达后不会重复推送。
- -当前不附带签名头。建议在 callback_url 路径中放置一段随机 token,由你在收到回调时自行校验来源。
- -回调地址建议使用公网 HTTPS 端点,并能在 10 秒内返回响应(单次超时为 10s)。
任务状态
pending任务已排队,等待处理processing音频生成中completed音频生成成功failed音频生成失败错误码
400请求错误 - 参数缺失或无效401未授权 - API 密钥无效402余额不足 - 积分不够404未找到 - 任务 ID 不存在500服务器内部错误注意事项
- *音频文件保存 30 天,请及时下载
- *文生音效支持 3.0 到 10.0 秒时长
- *视频配音要求视频时长 3-20 秒
- *语音合成每次最多 1000 字符
- *视频配音需提供 video_id 或 video_url 其中之一
- *建议每 5-10 秒轮询一次状态
常见问题
Kling 音频 API 能做什么?
TTS、音效生成、视频转音频(给视频配音轨)——都在 POST /api/v1/audio/generations,一把 Key。