畅怀中转 API 文档

主题

gpt-tts ​

接口说明 ​

提供基于 gpt-4o-mini-tts TTS 模型的文本转语音服务，支持多种音色选择。

基础概念 ​

  • TTS(Text-to-Speech): 将文本转换为自然语音的技术

  • 音色(Voice): 合成语音的声音特征，本API支持多种预设音色

请求地址 ​

POST https://api.changhuai.ai/v1/audio/speech

请求头 ​

python
headers = {
    "Authorization": "Bearer ******",  # 替换为您的API密钥
    "Content-Type": "application/json"
}

请求参数 ​

参数名

类型

必填

说明

model

string

是

固定值 “gpt-4o-mini-tts”

input

string

是

需要转换为语音的文本内容

voice

string

是

音色类型，如 “alloy”

Python 调用示例 ​

python
import requests
import json

url = "https://api.changhuai.ai/v1/audio/speech"
api_key = "******"  # 替换为您的API密钥

payload = {
    "model": "gpt-4o-mini-tts",
    "input": "我是API，欢迎使用语音合成服务",
    "voice": "alloy"
}

try:
    # 发送POST请求
    response = requests.post(url, 
                           headers={"Authorization": f"Bearer {api_key}"},
                           json=payload)
    
    # 检查响应状态
    response.raise_for_status()
    
    # 处理音频响应
    if response.headers["Content-Type"] in ("audio/mpeg", "audio/mp3"):
        with open("output.mp3", "wb") as f:
            f.write(response.content)  # 写入音频文件
        print("语音合成成功，已保存为output.mp3")
    else:
        print("错误响应:", response.text)

except Exception as e:
    print(f"请求出错: {e}")

响应说明 ​

  • 成功: 返回MP3格式的音频流，Content-Type为audio/mpeg

  • 失败: 返回JSON格式的错误信息

注意事项 ​

  1. API密钥需妥善保管，不要暴露在客户端代码中

  2. 输入文本长度建议不超过500字符

  3. 音频采样率为24kHz，比特率128kbps