在线调用 API
文字转语音
使用自己的 API Key 发起请求。价格与可用选项根据当前应用实时加载。
在线调试
登录并创建 API 密钥后即可调用。TTS 需要音频权限，视频工具需要视频权限。
执行会按当前配置从 API 余额扣费。
调用结果
当前 API 单位积分价格
选择 API 密钥后加载当前价格。
接入示例
cURL
curl 'https://aihub-admin.aimix.pro/api-platform/v1/tts/synthesize' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
-d '{
"text": "",
"provider": "microsoft-api",
"voiceId": ""
}'TypeScript
const response = await fetch("https://aihub-admin.aimix.pro/api-platform/v1/tts/synthesize", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
"text": "",
"provider": "microsoft-api",
"voiceId": ""
})
});
const result = await response.json();
if (!response.ok || result.code !== 1000) throw new Error(result.message);
console.log(result.data);Python
import json, os, requests
response = requests.post("https://aihub-admin.aimix.pro/api-platform/v1/tts/synthesize",
headers={"Authorization": "Bearer " + os.environ["PIXMIND_API_KEY"]},
json=json.loads("{\n \"text\": \"\",\n \"provider\": \"microsoft-api\",\n \"voiceId\": \"\"\n}"), timeout=120)
response.raise_for_status()
result = response.json()
if result["code"] != 1000: raise RuntimeError(result["message"])
print(result["data"])
应用场景
适用场景
工作流场景示意
为视频制作解说
将完成的文稿合成为配音，再把音轨加入视频编辑器。
工作流场景示意
朗读产品与课程内容
将说明文案、教学内容或产品演示转成可复用的语音素材。
工作流场景示意
制作文章与书籍朗读
把文章或书籍段落转成音频，各章节保持相同音色，形成连贯的听读体验。
按音频工作流选择供应商
| API 选项 | 微软 | 火山 | MiniMax | 讯捷国语 | |
|---|---|---|---|---|---|
| 供应商 ID | microsoft-api | google-genai | huoshan_big_model | MiniMax | xjguoyu |
| 输出格式 | MP3 | MP3 / WAV / OGG | MP3 / WAV | MP3 | WAV |
| 语速范围 | −100…100 | 0…2 | 0.8…2 | 0.5…2 | 0…2 |
| 风格控制 | 语速、音调、音量 | stylePrompt | 语速和音量 | emotion | 语速和音量 |
| 计费方式 | 不收 API 积分 | 每 100 字符 | 每 100 字符 | 每 100 字符 | 每 100 字符 |
参数核验日期：2026 年 10 月 9 日
API 参数文档从输入到输出
- 01
准备朗读文稿
粘贴需要朗读的文字，用标点和段落组织希望表达的语句。
- 02
选择供应商与音色
使用有音频权限的 API Key，查看已配置供应商，有样音时先试听。
- 03
合成并下载
提交一次请求，试听返回的音频，再下载到视频或应用流程中使用。
常见问题
有哪些语音供应商可以选择？
API 支持 Microsoft、Google、火山、MiniMax 和讯捷国语线路。当前 API 服务已配置的供应商才可实际运行。
如何找到正确的音色 ID？
使用音色选择器或 GET /api-platform/v1/tts/voices。音色必须属于合成请求中指定的同一供应商。
单次可以提交多少文字？
单次接受 1 至 10,000 字符的非空白文字。更长的稿件需拆分请求，并在应用中保持段落顺序。
会返回什么音频格式？
Microsoft、Google、火山和 MiniMax 默认 MP3，讯捷国语默认 WAV。Google 还接受 WAV、OGG，火山还接受 WAV；请按供应商文档选择格式。
可以调整语速和情绪吗？
API 接受各供应商范围内的语速、音调和音量。stylePrompt 仅用于 Google，emotion 仅用于 MiniMax。本页使用默认参数，定制控制请参考文档。
语音合成如何计算积分？
付费供应商每 100 字符为一个计费单位，不足向上取整，并使用当前 API 单价。Microsoft 线路当前不收 API 积分，可用性仍取决于服务配置。
TTS 需要像视频一样轮询任务吗？
不需要，此接口直接返回合成结果，其中包含音频链接与用量，不使用视频任务查询接口。
重试时如何避免重复扣费？
相同请求体复用同一个 Idempotency-Key。已完成请求返回缓存结果；处理中、请求变化或结果不确定时返回冲突。超时后不要自动换新 Key 再次提交。