快速开始
将 TTSMaker API 的域名 api.ttsmaker.com 替换为本服务地址即可。你需要在 TTSMaker 申请自己的 API Key。
TTSMaker API 限制每个 Key 每秒 1 次请求 (1 QPS)。音频下载链接有效期 2~24 小时。
接口列表
GET/api/voice-list获取可用声音列表
| 参数 | 类型 | 必填 | 说明 |
|---|
api_key | string | 是 | 你的 TTSMaker API Key |
language | string | 否 | 按语言筛选 |
curl "https://your-worker.workers.dev/api/voice-list?api_key=your_key"
POST/api/create-tts-order文字转语音，返回音频下载链接
| 参数 | 类型 | 必填 | 说明 |
|---|
api_key | string | 是 | TTSMaker API Key |
text | string | 是 | 文本 (最大 20000 字符) |
voice_id | int | 是 | 声音 ID |
audio_format | string | 否 | mp3/wav/ogg/aac |
audio_speed | float | 否 | 语速 0.5~2.0 |
audio_volume | float | 否 | 音量 0.1~2.0 |
audio_pitch | float | 否 | 音调 0.5~2.0 |
curl -X POST "https://your-worker.workers.dev/api/create-tts-order" \
-H "Content-Type: application/json" \
-d '{"api_key":"your_key","text":"你好世界","voice_id":101,"audio_format":"mp3"}'
GET/api/token-status查询 API Key 配额
curl "https://your-worker.workers.dev/api/token-status?api_key=your_key"
GET/api/download-audio代理下载音频文件
curl "https://your-worker.workers.dev/api/download-audio?url=音频URL" -o audio.mp3
Python 示例
import requests
BASE = "https://your-worker.workers.dev"
API_KEY = "your_ttsmaker_key"
# 获取声音列表
resp = requests.get(f"{BASE}/api/voice-list", params={"api_key": API_KEY})
voices = resp.json()
print(f"可用声音: {len(voices.get('voices_detailed_list', []))} 个")
# 文字转语音
resp = requests.post(f"{BASE}/api/create-tts-order", json={
"api_key": API_KEY, "text": "你好世界", "voice_id": 101, "audio_format": "mp3"
})
audio_url = resp.json().get("audio_download_url", "")
# 代理下载音频
audio = requests.get(f"{BASE}/api/download-audio", params={"url": audio_url})
with open("output.mp3", "wb") as f:
f.write(audio.content)