创建自定义音色任务
更新时间：2026-03-30
根据输入的音视频文件链接或历史作品ID提取并定制专属音色，返回 task_id 用于后续查询结果
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型名称。
固定值：Custom-Voices。
必选
type
string
任务类型。
固定值：custom-voices。
必选
model_parameters
object {3}
模型参数配置。
必选
显示子属性
隐藏子属性
voice_name
string
音色名称。
文本内容最大长度 20 个字符。
创建后不再使用的音色可通过 API 删除。
必选
voice_url
string
音色数据文件获取链接。
支持 .mp3 / .wav / .mp4 / .mov 格式的音视频文件。
音频中人声需干净无杂音，有且只能有一种人声。
时长不短于 5 秒且不长于 30 秒。
可选
video_id
string
历史作品 ID，可通过引用历史作品提供音频素材。
仅满足以下条件的视频可以用于定制音色：
使用 K2.6 版本模型生成且开启 sound 参数值为 on 的视频。
通过数字人 API 生成的视频。
通过对口型 API 生成的视频。
注：人声需干净无杂音，单一声音，时长 5s~30s。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "Custom-Voices",
"type": "custom-voices",
"model_parameters": {
"voice_name": "qatest111",
"voice_url": "https://xxxxxxxx"
}
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "Custom-Voices",
"type": "custom-voices",
"model_parameters": {
"voice_name": "qatest111",
"voice_url": "https://xxxxxxxxxx"
}
}返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码。
必选
message
string
错误信息。
必选
request_id
string
请求ID。
必选
data
object {5}
返回数据体，包含任务相关信息。
必选
显示子属性
隐藏子属性
task_id
string
任务ID。
必选
task_status
string
任务状态。
submitted：已提交processing：处理中succeed：成功failed：失败
必选
created_at
integer
任务创建时间，Unix 时间戳（毫秒）。
必选
updated_at
integer
任务更新时间，Unix 时间戳（毫秒）。
必选
task_info
object
任务详细信息。
必选
显示子属性
隐藏子属性
成功响应
{
"code": 0,
"message": "",
"request_id": "as-yhcxxxtspk",
"data": {
"task_id": "69ca1bxxxxxxx7f4231627",
"task_status": "submitted",
"created_at": 1774852908000,
"updated_at": 1774852908000,
"task_info": {}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_generation_internal_error | video generation service internal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_generation_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章