音色克隆 (Voice Clone)

音色克隆接口，上传音频样本即可克隆指定音色。克隆后的音色可用于语音合成，实现个性化 TTS。

API 端点

POST/voice_clone

创建音色克隆任务

GET/voice_clone/list

获取已克隆音色列表

请求参数

参数名	类型	必填	说明
`file_id`	string	必填	已上传的音频文件 ID
`voice_name`	string	必填	音色名称
`description`	string	可选	音色描述

请求示例

{
  "file_id": "file_xxxxx",
  "voice_name": "我的音色",
  "description": "基于示例音频克隆的音色"
}

响应示例

{
  "voice_id": "voice_clone_xxxxx",
  "voice_name": "我的音色",
  "status": "completed",
  "created_at": 1234567890
}

代码示例

import requests

# 步骤1：上传音频文件
upload_url = "https://your-proxy-domain.com/v1/files/upload"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

files = {"file": open("voice_sample.mp3", "rb")}
data = {"purpose": "voice_clone"}
upload_resp = requests.post(upload_url, headers=headers, files=files, data=data)
file_id = upload_resp.json()["file_id"]

# 步骤2：克隆音色
clone_url = "https://your-proxy-domain.com/v1/voice_clone"
clone_data = {
    "file_id": file_id,
    "voice_name": "我的音色",
    "description": "基于示例音频克隆的音色"
}
clone_resp = requests.post(
    clone_url,
    headers={**headers, "Content-Type": "application/json"},
    json=clone_data
)
print(clone_resp.json())