TTS语音合成（OpenAI兼容）接口说明

接口概述

本接口兼容OpenAI TTS接口规范，支持通过HTTP POST请求将文本转换为高质量语音，支持多种模型、音色、音频格式配置，同时兼容主流国产模型（如IndexTTS、ChatTTS、CosyVoice等）的扩展参数，满足不同场景下的语音合成需求。

支持模型

请求地址

本接口兼容 OpenAI 的接口规范，可直接用 OpenAI SDK 进行调用。

POST https://www.yuntts.com/api/v1/audio/speech

请求头

请求参数

IndexTTS-1.5

ChatTTS

IndexTTS-2

CosyVoice2-0.5B

Step-Audio-TTS-3B

fish-speech-1.2-sft

MegaTTS3

CosyVoice

MiniMax

Qwen-TTS

响应格式

成功响应

Content-Type: audio/mpeg (或其他音频格式)

响应体为二进制音频数据。

错误响应

{
  "code": 400,
  "error": "rest_invalid_param",
  "message": "input/inputs/text is required"
}

计费说明

1. 字符计算: 接口自动计算请求文本的字符数（支持中文、英文、标点符号）
2. 价格配置: 不同模型有不同的价格，具体可查看语音合成服务计费说明
3. 用户折扣: VIP 用户享受 9 折优惠，BoosVIP 用户享受 8 折优惠
4. 最低扣费: 每次请求最低扣费 0.001 元

请求示例

Python 请求示例

from openai import OpenAI

client = OpenAI(
    base_url="https://www.yuntts.com/api/v1",
    api_key="YOUR_API_KEY"
)

response = client.audio.speech.create(
    input="你好，欢迎使用语音合成服务。今天天气真不错！",
    model="IndexTTS-2",
    response_format="mp3"
)

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

cURL 请求示例

curl https://www.yuntts.com/api/v1/audio/speech 
  -X POST 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -d '{
    "input": "你好，欢迎使用语音合成服务。今天天气真不错！",
    "model": "IndexTTS-2",
    "response_format": "mp3"
  }' 
  --output output.mp3

PHP 请求示例

<?php

$url = 'https://www.yuntts.com/api/v1/audio/speech';
$headers = array(
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_KEY'
);

$data = array(
    'input' => '你好，欢迎使用语音合成服务。今天天气真不错！',
    'model' => 'IndexTTS-2',
    'response_format' => 'mp3'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curl_error = curl_error($ch);
curl_close($ch);

// 保存音频文件
file_put_contents('output.mp3', $response);

JavaScript (Node.js) 请求示例

const https = require('https');
const fs = require('fs');

const data = JSON.stringify({
    input: '你好，欢迎使用语音合成服务。今天天气真不错！',
    model: 'IndexTTS-2',
    response_format: 'mp3'
});

const options = {
    hostname: 'https://www.yuntts.com',
    port: 80,
    path: '/api/v1/audio/speech',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Length': data.length
    }
};

const req = https.request(options, (res) => {
    const chunks = [];
    res.on('data', (chunk) => chunks.push(chunk));
    res.on('end', () => {
        const buffer = Buffer.concat(chunks);
        fs.writeFileSync('output.mp3', buffer);
    });
});

req.write(data);
req.end();

错误码

注意事项

1. 超时设置: 默认超时时间为 60 秒，如需更长的处理时间请在代理层面调整
2. 字符编码: 请确保输入文本为 UTF-8 编码
3. 音频格式: 不同平台支持的音频格式可能不同，请根据实际需求选择