APIMODELSAPIMODELS
API 文档

apimodels.app

Docs/Kling (可灵) 音频生成 API
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。