1. 音色克隆
饺子配音开放平台
  • 免费 Edge-TTS
    • Edge TTS语音合成
      POST
  • Index-TTS2通用
    • 音色克隆
      • 音色查询
        POST
      • 音色克隆
        POST
      • 删除音色
        POST
      • 语音合成
        POST
    • 实时合成
      • 语音合成
  • Index‑TTS2会员专业版
    • IndexTTS-2同步(高清)
      • IndexTTS2高清音质
    • IndexTTS2异步(专业版)
      • 语音合成
      • 任务查询
      • 取消任务
  • IndexTTS2会员旗舰版
    • Index-TTS2 异步语音合成请求
      POST
    • Index-TTS2 任务状态查询请求
      POST
  • CosyVoice
    • 声音克隆
      POST
    • 音色设计
      POST
    • 更新音色
      POST
    • 语音合成
      POST
    • 删除音色
      POST
  • Qwen3-TTS
    • 语音合成
      POST
    • 音色克隆
      POST
    • 音色设计
      POST
    • 删除音色
      POST
  • 通用音色查询
    • 音色查询
      POST
  • 微软TTS
    • 微软SSML模式[推荐]
      POST
    • 微软语音合成[普通文本]
      POST
  1. 音色克隆

音色克隆

开发中
POST
indextts2_cloning

IndexTTS-2 音色克隆 API#

接口信息#

接口路径: POST https://www.jiaozitts.com/api/v1/indextts2_cloning
认证方式: Authorization: Bearer <api_key>

请求方式#

支持两种请求格式:

方式一:multipart/form-data(文件上传)#

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

请求头#

请求参数#

参数名类型必填说明
namestring是音色名称
descriptionstring否音色描述
speaker_filefile三选一说话人音频文件(mp3/wav,5-30秒,≥16kHz,≤20MB)
speaker_file_base64string三选一说话人音频Base64编码
speaker_urlstring三选一说话人音频URL
emotion_filefile可选三选一情感音频文件(同上)
emotion_file_base64string可选三选一情感音频Base64编码
emotion_urlstring可选三选一情感音频URL

示例#

方式二:application/json(JSON数据)#

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

请求头#

请求参数#

参数名类型必填说明
namestring是音色名称
descriptionstring否音色描述
speaker_file_base64string三选一说话人音频Base64编码
speaker_urlstring三选一说话人音频URL
emotion_file_base64string可选三选一情感音频Base64编码
emotion_urlstring可选三选一情感音频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 状态码错误码说明
400empty_name缺少音色名称
400missing_speaker_file缺少 speaker_file/speaker_file_base64/speaker_url
400invalid_file_format音频文件格式不支持(需mp3/wav)
400file_too_large文件大小超过20MB
400invalid_speaker_file音频时长或采样率不符合要求
400invalid_speaker_urlspeaker_url格式无效
400invalid_emotion_file_format情感音频格式不支持
400emotion_file_too_large情感音频超过20MB
400invalid_emotion_file情感音频时长或采样率不符合要求
400invalid_emotion_urlemotion_url格式无效
401empty_key缺少Authorization头
401invalid_keyAPI密钥无效
405method_not_allowed非POST请求
500request_failed请求失败

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://www.jiaozitts.com/api/v1/indextts2_cloning' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'name=""' \
--form 'description=""' \
--form 'speaker_file=@""' \
--form 'emotion_file=@""'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-07-30 11:18:30
上一页
音色查询
下一页
删除音色
Built with