IndexTTS-2 音色克隆 API

接口信息

接口路径: POST https://www.yuntts.com/api/v1/indextts2_cloning

认证方式: Authorization: Bearer <api_key>

特别注意

音色克隆，音色在服务器仅保存7天，过期自动清理，过期后需要重新克隆！

请求方式

支持两种请求格式：

方式一：multipart/form-data（文件上传）

适用于直接上传音频文件的场景。

请求头

请求参数

参数名	类型	必填	说明
`name`	string	是	音色名称
`description`	string	否	音色描述
`speaker_file`	file	三选一	说话人音频文件（mp3/wav，5-30秒，≥16kHz，≤20MB）
`speaker_file_base64`	string	三选一	说话人音频Base64编码
`speaker_url`	string	三选一	说话人音频URL
`emotion_file`	file	可选三选一	情感音频文件（同上）
`emotion_file_base64`	string	可选三选一	情感音频Base64编码
`emotion_url`	string	可选三选一	情感音频URL

示例

方式二：application/json（JSON数据）

适用于传递 Base64 编码或 URL 的场景。

请求头

请求参数

参数名	类型	必填	说明
`name`	string	是	音色名称
`description`	string	否	音色描述
`speaker_file_base64`	string	三选一	说话人音频Base64编码
`speaker_url`	string	三选一	说话人音频URL
`emotion_file_base64`	string	可选三选一	情感音频Base64编码
`emotion_url`	string	可选三选一	情感音频URL

注意：JSON 方式不支持直接上传文件（speaker_file、emotion_file），只能使用 Base64 或 URL。

示例

音频文件要求

属性	要求
格式	mp3、wav
时长	5-30秒
采样率	≥16kHz
大小	≤20MB

响应格式

成功响应

{
    "code": 200,
    "message": "上传成功！",
    "data": {
        "id": "v_abc123",
        "name": "我的音色",
        "status": "DEPLOYING",
        "created_at": "2024-01-01T00:00:00Z"
    }
}

错误响应

{
    "code": 400,
    "error": "invalid_speaker_file",
    "message": "音频时长不符合要求（5-30秒）"
}

错误码说明

HTTP 状态码	错误码	说明
400	`empty_name`	缺少音色名称
400	`missing_speaker_file`	缺少 speaker_file/speaker_file_base64/speaker_url
400	`invalid_file_format`	音频文件格式不支持（需mp3/wav）
400	`file_too_large`	文件大小超过20MB
400	`invalid_speaker_file`	音频时长或采样率不符合要求
400	`invalid_speaker_url`	speaker_url格式无效
400	`invalid_emotion_file_format`	情感音频格式不支持
400	`emotion_file_too_large`	情感音频超过20MB
400	`invalid_emotion_file`	情感音频时长或采样率不符合要求
400	`invalid_emotion_url`	emotion_url格式无效
401	`empty_key`	缺少Authorization头
401	`invalid_key`	API密钥无效
405	`method_not_allowed`	非POST请求
500	`request_failed`	请求失败

音色克隆

IndexTTS-2 音色克隆 API

接口信息

特别注意

请求方式

方式一：multipart/form-data（文件上传）

请求头

请求参数

示例

方式二：application/json（JSON数据）

请求头

请求参数

示例

音频文件要求

响应格式

成功响应

错误响应

错误码说明

请求参数

请求示例代码

返回响应

音色克隆

IndexTTS-2 音色克隆 API#

接口信息#

特别注意#

请求方式#

方式一：multipart/form-data（文件上传）#

请求头#

请求参数#

示例#

方式二：application/json（JSON数据）#

请求头#

请求参数#

示例#

音频文件要求#

响应格式#

成功响应#

错误响应#

错误码说明#

请求参数

请求示例代码

返回响应

IndexTTS-2 音色克隆 API

接口信息

特别注意

请求方式

方式一：multipart/form-data（文件上传）

请求头

请求参数

示例

方式二：application/json（JSON数据）

请求头

请求参数

示例

音频文件要求

响应格式

成功响应

错误响应

错误码说明