ChatTTS 语音合成API接口文档

前言说明

本接口基于 ChatTTS 开发的语音合成服务，支持系统音色和自定义音色，将文本转换为自然流畅的语音，由云声配音提供技术支持。

核心特性：

• 按次计费：每次调用固定收费，与文本长度无关
• 多种预设音色：支持 alloy、echo、fable、onyx、nova、shimmer 六种音色
• 自定义音色：支持 .pt 格式文件链接自定义音色
• 口语化控制：支持 [oral_0] ~ [oral_9] 调节口语化程度
• 音频直出：始终以音频二进制流返回，无需轮询

接口信息

请求参数

请求示例

预设音色合成：

{
    "input": "欢迎使用语音合成服务",
    "voice": "nova"
}

自定义音色合成：

{
    "input": "欢迎使用语音合成服务",
    "voice_url": "https://example.com/voice.pt"
}

默认音色合成（不传 voice/voice_url）：

{
    "input": "欢迎使用语音合成服务"
}

响应说明

✅ 成功响应

接口始终以音频二进制流返回，不返回 JSON。

响应头：

响应体：

原始音频二进制数据，直接作为 HTTP 响应体返回。

❌ 错误响应

接口返回 JSON：

{
    "code": "错误码",
    "message": "错误描述"
}

常见错误码：

对接示例

cURL

curl -X POST "https://www.yuntts.com/api/v1/chattts" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer YOUR_TOKEN" 
  -d '{
    "input": "欢迎使用语音合成服务",
    "voice": "nova"
  }' 
  --output output.wav

JavaScript (Fetch)

const response = await fetch('https://www.yuntts.com/api/v1/chattts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    input: '欢迎使用语音合成服务',
    voice: 'nova'
  })
});

// 获取响应头中的元数据
const charCount = response.headers.get('X-Characters');
const cost = response.headers.get('X-Cost');
const taskId = response.headers.get('X-Task-Id');

// 获取音频 Blob 并播放
const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);
const audio = new Audio(audioUrl);
audio.play();

Python

import requests

response = requests.post(
    url='https://www.yuntts.com/api/v1/chattts',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    },
    json={
        'input': '欢迎使用语音合成服务',
        'voice': 'nova'
    }
)

# 获取响应头中的元数据
char_count = response.headers.get('X-Characters')
cost = response.headers.get('X-Cost')
task_id = response.headers.get('X-Task-Id')

# 保存音频文件
with open('output.wav', 'wb') as f:
    f.write(response.content)

PHP

$response = wp_remote_post('https://www.yuntts.com/api/v1/chattts', array(
    'headers' => array(
        'Content-Type' => 'application/json',
        'Authorization' => 'Bearer ' . $token,
    ),
    'body' => json_encode(array(
        'input' => '欢迎使用语音合成服务',
        'voice' => 'nova',
    )),
));

// 获取响应头中的元数据
$char_count = wp_remote_retrieve_header($response, 'X-Characters');
$cost = wp_remote_retrieve_header($response, 'X-Cost');
$task_id = wp_remote_retrieve_header($response, 'X-Task-Id');

// 获取音频内容
$audio_content = wp_remote_retrieve_body($response);

// 保存为文件或直接输出
file_put_contents('output.wav', $audio_content);

计费说明

说明：ChatTTS 按次计费，与合成文本长度无关。API 请求失败时自动全额退款。