认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: kirin_custom_voices
voice_name string 必填
音色名称, 创建后不再使用的音色可通过 API 删除
注：文本内容最大长度 20 个字符
voice_url string
音色数据文件获取链接
支持 .mp3 / .wav / .mp4 / .mov 格式的音视频文件
音频中人声需干净无杂音, 有且只能有一种人声, 时长不短于 5 秒且不长于 30 秒
video_id string
历史作品 ID, 可通过引用历史作品提供音频素材
仅满足以下条件的视频可以用于定制音色：
使用 V2.6 版本模型生成且开启 sound 参数值为 on 的视频
通过数字人 API 生成的视频
通过对口型 API 生成的视频
注：音频中人声需干净无杂音, 有且只能有一种人声, 时长不短于 5 秒且不长于 30 秒
callback_url string
回调 URL
external_task_id string
自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
注：单用户下需要保证唯一性
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧