📋 EdgeTTS 完整 API 文档

🌐 基础信息

项目	值
API 地址	https://edgetts.aws.xin
认证方式	Bearer Token
内容类型	application/json
API 版本	v1

📡 端点 1: 文本转语音

POST /v1/audio/speech

请求头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

基础参数

参数	类型	必需	默认值	说明
input	string	必需	-	要转换的文本
voice	string	必需	-	语音模型名称
model	string	可选	tts-1	模型类型 (tts-1, tts-1-hd)
response_format	string	可选	mp3	音频格式 (mp3/opus/aac/flac)

语音控制参数

参数	类型	范围	默认值	说明
speed	number	0.25 - 2.0	1.0	语速倍率
pitch	number	0.5 - 1.5	1.0	音调倍率

流式输出参数 推荐

参数	类型	默认值	说明
stream	boolean	false	启用流式输出（响应更快）

高级参数

参数	类型	范围	默认值	说明
concurrency	number	1 - 50	10	并发请求数
chunk_size	number	50 - 1000	300	文本分块大小（字符）

文本清理参数 新功能

使用 cleaning_options 对象配置文本清理：

参数	类型	默认值	说明
remove_markdown	boolean	false	移除 Markdown 格式（# ** []等）
remove_emoji	boolean	false	移除 Emoji 表情 😊
remove_urls	boolean	false	移除 URL 链接
remove_line_breaks	boolean	false	移除换行符
remove_citation_numbers	boolean	false	移除引用数字 [1] [2]
custom_keywords	string	""	自定义移除关键词（逗号分隔）

完整请求示例

{
  "input": "# 标题\n你好世界 😊 https://example.com [1]",
  "voice": "zh-CN-XiaoxiaoNeural",
  "speed": 1.2,
  "pitch": 1.0,
  "stream": true,
  "response_format": "mp3",
  "cleaning_options": {
    "remove_markdown": true,
    "remove_emoji": true,
    "remove_urls": true,
    "remove_line_breaks": true,
    "remove_citation_numbers": true,
    "custom_keywords": "测试,删除"
  }
}

📡 端点 2: 获取语音列表

GET /v1/models

请求头

Authorization: Bearer YOUR_API_KEY

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "zh-CN-XiaoxiaoNeural",
      "object": "model",
      "created": 1677649963,
      "owned_by": "microsoft",
      "language": "zh-CN",
      "gender": "Female",
      "description": "晓晓 - 温柔女声"
    }
  ]
}

cURL 示例

curl 'https://edgetts.aws.xin/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

🎤 可用语音列表

🇬🇧 英语 (7个)

语音 ID	名称	性别	口音
en-GB-SoniaNeural	Sonia	女	英国英语 ⭐推荐
en-GB-RyanNeural	Ryan	男	英国英语
en-US-AvaMultilingualNeural	Ava	女	美国英语
en-US-AndrewMultilingualNeural	Andrew	男	美国英语
en-US-EmmaMultilingualNeural	Emma	女	美国英语
en-US-BrianMultilingualNeural	Brian	男	美国英语
en-AU-WilliamMultilingualNeural	William	男	澳洲英语

🇨🇳 中文 (2个)

语音 ID	名称	性别	特点
zh-CN-XiaoxiaoNeural	晓晓	女	温柔自然
zh-CN-YunxiNeural	云希	男	年轻活力

🇩🇪 德语 (2个)

de-DE-FlorianMultilingualNeural	Florian	男	-
de-DE-SeraphinaMultilingualNeural	Seraphina	女	-

🇫🇷 法语 (2个)

fr-FR-RemyMultilingualNeural	Remy	男	-
fr-FR-VivienneMultilingualNeural	Vivienne	女	-

💡 使用示例

1. 基础调用

curl -X POST 'https://edgetts.aws.xin/v1/audio/speech' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "Hello world",
    "voice": "en-GB-SoniaNeural"
  }' \
  --output audio.mp3

2. 流式输出（推荐）

curl -X POST 'https://edgetts.aws.xin/v1/audio/speech' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "Hello world",
    "voice": "en-GB-SoniaNeural",
    "stream": true
  }' \
  --output audio.mp3

3. 语速和音调控制

curl -X POST 'https://edgetts.aws.xin/v1/audio/speech' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "测试语速和音调",
    "voice": "zh-CN-XiaoxiaoNeural",
    "speed": 1.5,
    "pitch": 1.2
  }' \
  --output audio.mp3

4. 文本清理

curl -X POST 'https://edgetts.aws.xin/v1/audio/speech' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "# 标题\n**粗体** 😊 https://example.com [1]",
    "voice": "zh-CN-XiaoxiaoNeural",
    "cleaning_options": {
      "remove_markdown": true,
      "remove_emoji": true,
      "remove_urls": true,
      "remove_line_breaks": true,
      "remove_citation_numbers": true
    }
  }' \
  --output audio.mp3

5. 停顿控制

curl -X POST 'https://edgetts.aws.xin/v1/audio/speech' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "第一句话。<break time=\"2.0s\"/>停顿2秒。第二句话。",
    "voice": "zh-CN-XiaoxiaoNeural"
  }' \
  --output audio.mp3

⚠️ 错误响应

状态码	错误代码	说明
401	invalid_api_key	API Key 无效或缺失
400	missing_parameter	缺少必需参数
400	invalid_voice	语音模型不存在
400	text_too_long	文本过长（建议<10000字符）
500	tts_error	TTS 服务错误

📊 性能数据

场景	平均延迟	评级
英文短文本（流式）	143ms	⭐⭐⭐⭐⭐ 优秀
中文短文本（流式）	180ms	⭐⭐⭐⭐⭐ 优秀
标准输出	643ms	⭐⭐⭐⭐ 良好