文档

创建自定义音色

更新时间:2026-11-04

POST
/v3/aigc/kl/general/custom-voices

上传音频 / 视频定制音色,供生视频 voice_list 或主体绑定使用。

任务状态:

  • submitted: 已提交
  • processing: 处理中
  • succeed: 成功
  • failed: 失败

使用 TE 北京地域 API Key 鉴权。模型能力、调用约定见 Kling 接口概览。

身份验证

BearerAuth
headerAuthorizationBearer <token>

TE 北京地域 API Key,填写后自动添加 Bearer 前缀。

请求体

application/json
  1. body
voice_name*string

≤ 20 字符

voice_url?string

mp3/wav/mp4/mov;人声干净、仅一种人声,5~30s

响应体

成功;具体状态及结果见响应字段。

application/json
  1. response
code?string
message?string
requestId?string
data?
请求示例
curl -X POST 'https://vod.bj.baidubce.com/v3/aigc/kl/general/custom-voices' \  -H 'Content-Type: application/json' \  -d '{  "voice_name": "my-voice",  "voice_url": "https://example.com/voice.mp3"}'
响应示例200
{  "code": "string",  "message": "string",  "requestId": "string",  "data": {    "task_id": "tsk-xxxxxxxxxxxxxxxx",    "task_status": "submitted",    "created_at": 1722769557708,    "updated_at": 1722769557708  }}