文字转语音API（TTS）接入指南

接口速览

以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。

请求参数

响应示例

成功响应（HTTP 200）

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "code": 200,
    "message": "success",
    "url": "https://file.luanqing.net/5555api/voice/tts_xxx.wav",
    "desc": "语音文件的网络地址"
  }
}

调用示例

cURL 示例

# V1 基础合成
curl -X POST 'https://5555api.com/data/api/fetchVoiceByText' \
  -H 'Content-Type: application/json' \
  -d '{"apikey":"YOUR_APIKEY","text":"欢迎使用轻语API文字转语音接口"}'

# V2 多角色合成（语速加快、音调升高）
curl -X POST 'https://5555api.com/data/api/fetchVoiceByText_v2' \
  -H 'Content-Type: application/json' \
  -d '{"apikey":"YOUR_APIKEY","text":"今天天气真不错","role":"国语|女|悦悦","rate":"fast1","pitch":"fast1"}'

JavaScript 示例

const body = {
  apikey: 'YOUR_APIKEY',
  text: '欢迎使用轻语API文字转语音接口',
  role: '国语|女|悦悦',   // V2 可选
  rate: 'normal',        // 语速，V2 可选
  volume: 'normal',      // 音量，V2 可选
  pitch: 'normal'        // 音调，V2 可选
};

const resp = await fetch('https://5555api.com/data/api/fetchVoiceByText_v2', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(body)
});
const result = await resp.json();
if (result.code === 200 && result.data.url) {
  new Audio(result.data.url).play(); // 直接播放合成语音
}

Python 示例

import requests

resp = requests.post(
    'https://5555api.com/data/api/fetchVoiceByText_v2',
    json={
        'apikey': 'YOUR_APIKEY',
        'text': '欢迎使用轻语API文字转语音接口',
        'role': '国语|男|小明',
        'rate': 'fast1'
    }
)
result = resp.json()
if result['code'] == 200:
    print('音频地址:', result['data']['url'])

应用场景

常见问题

相关 API 与开发资源

继续查看轻语API开放平台的接口分类和可直接体验的在线工具。