Openai 请求格式 TTS 语音合成 API 文档

接口说明

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

基础概念

• TTS(Text-to-Speech): 将文本转换为自然语音的技术
• 音色(Voice): 合成语音的声音特征，本API支持多种预设音色

请求地址

POST https://www.dmxapi.cn/v1/audio/speech

请求头

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

请求参数

参数名	类型	必填	说明
model	string	是	固定值 "gpt-4o-mini-tts"
input	string	是	需要转换为语音的文本内容
voice	string	是	音色类型，如 "alloy"

Python 调用示例

import requests
import json

url = "https://www.dmxapi.cn/v1/audio/speech"
api_key = "******"  # 替换为您的API密钥

payload = {
    "model": "gpt-4o-mini-tts",
    "input": "我是DMXAPI，欢迎使用语音合成服务",
    "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