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

接口速览

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

请求参数

长文本文字转语音

长文本接口独立于 V4 短文本接口，适合文章、课程、播报等较长内容。接口服务端会完成任务等待、音频下载和本地保存，调用方仍然只接收平台自己的音频地址。

长文本接口的 apikey、text、role、rate、volume、pitch 参数格式与 V2/V4 保持一致。音频生成失败不会扣除本次金豆。

计费规则

V4 与长文本分别按各自的音色品质和实际字符数扣除金豆；合成失败或校验未通过时不会扣费。

V4 中文最多150个字符、纯英文最多500个字符；长文本最多50000个 Unicode 字符，仅支持普通和中级音色。V2 使用独立计费规则：15 个字符以内 6 金豆；超过 15 个字符后，每增加 10 个字符（不足 10 个按 10 个计）增加 3 金豆，不受 V4 音色品质影响。

响应示例

V2 成功响应（HTTP 200）

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

V4 成功响应（HTTP 200）

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

长文本接口成功响应（HTTP 200）

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

错误响应示例

{
  "code": 500,
  "msg": "中文文本最多支持150个汉字（全角标点符号按1个字符计算）",
  "data": null
}

请以 code 判断业务是否成功；接口可能以HTTP 200返回业务错误，具体原因以 msg 为准。

调用示例

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

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

# 长文本合成（最多50000个字符，仅普通/中级音色）
curl -X POST 'https://5555api.com/data/api/fetchVoiceByLongText' \
  -H 'Content-Type: application/json' \
  -d '{"apikey":"YOUR_APIKEY","text":"这里放入需要合成的长篇文本","role":"柔美女声","rate":"normal","volume":"normal","pitch":"normal"}'

JavaScript 示例

const body = {
  apikey: 'YOUR_APIKEY',
  text: '欢迎使用轻语API文字转语音接口',
  role: '柔美女声',    // V4 可选，默认柔美女声
  rate: 'normal',        // 语速，V4 可选
  volume: 'normal',      // 音量，V4 可选
  pitch: 'normal'        // 音调，V4 可选
};

const resp = await fetch('https://5555api.com/data/api/fetchVoiceByText_v4', {
  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_v4',
    json={
        'apikey': 'YOUR_APIKEY',
        'text': '欢迎使用轻语API文字转语音接口',
        'role': '沉稳大气男声',
        'rate': 'fast1'
    }
)
result = resp.json()
if result['code'] == 200:
    print('音频地址:', result['data']['url'])

应用场景

常见问题

相关 API 与开发资源

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