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

接口速览

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

请求参数

响应示例

V2 成功响应（HTTP 200）

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "url": "https://5555api.com/files/media/voice/tts_xxx.wav"
  }
}

V3 成功响应（HTTP 200）

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "url": "https://5555api.com/files/media/profile/upload/media/tts_xxx.mp3",
    "characterCount": 12,
    "chargedJindou": 6
  }
}

调用示例

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"}'

# V3 高稳定合成（请求参数与V2一致）
curl -X POST 'https://5555api.com/data/api/fetchVoiceByText_v3' \
  -H 'Content-Type: application/json' \
  -d '{"apikey":"YOUR_APIKEY","text":"欢迎使用轻语API文字转语音接口","role":"国语|女|颜颜","rate":"normal","volume":"normal","pitch":"normal"}'

JavaScript 示例

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

const resp = await fetch('https://5555api.com/data/api/fetchVoiceByText_v3', {
  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(); // 直接播放合成语音
  console.log('本次扣除钻石:', result.data.chargedJindou);
}

Python 示例

import requests

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

应用场景

常见问题

相关 API 与开发资源

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