TTS 语音合成

概述

文本转语音（TTS）：输入文本返回 base64 编码的 MP3 音频。 • **5 种音色**：女声主播 / 男声主播 / 男声说唱 / 女声四川话 / 男声低沉 • **500 字以内**：单次请求最多 500 字符（中英文均按 1 字符计） • **MP3 格式**：返回 audio/mpeg 编码，前端可直接播放 • **便利字段**：返回 audio_data_url + audio_size_bytes + audio_format / audio_mime • **典型场景**：新闻播报 / 短视频配音 / 有声书 / 语音通知 / 客服 IVR • **不缓存**：500 字音频约 1MB，重复合成概率低，避免 Redis 内存膨胀

鉴权

匿名每日 10 次、QPS 1；登录用户每日 30 次、QPS 3（全部免费）。本接口不缓存，每次请求都会调用服务。

获取 API Key：获取 API Key/account/keys

请求参数

POST · APPLICATION/JSON

{
  "text": "欢迎使用语音合成服务",
  "voice_type": "female_zhubo"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "text": "欢迎使用语音合成服务",
    "text_length": 10,
    "voice_type": "female_zhubo",
    "voice_name": "女声主播",
    "voice_desc": "标准普通话女声，主播风格，适合资讯播报",
    "audio": "SUQzAwAAAAAAAAAAAAAAA...（约 17000 字符 base64）",
    "audio_format": "mp3",
    "audio_mime": "audio/mpeg",
    "audio_size_bytes": 12750,
    "audio_data_url": "data:audio/mpeg;base64,SUQzAwAAAAA..."
  },
  "request_id": "abc123def456",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "欢迎使用语音合成服务",
  "voice_type": "female_zhubo"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-07

  首次上线，/api/tts/free 支持 5 种音色：女主播 / 男主播 / 男说唱 / 女四川话 / 男低沉 修复源码 BUG：voice_type 不支持时不再默默回退（明确返回 4000 + 支持列表，避免歧义） 新增便利字段：audio_data_url 拼好 data URL 直接 <audio src> 可播 新增 audio_size_bytes 解码后字节数 + audio_format / audio_mime 元信息 新增 voice_name / voice_desc，前端可直接展示音色描述 不缓存：500 字音频约 1MB base64，存 Redis 代价过高且重复概率低 支持 application/json 请求体 说唱音色（male_rap）响应较慢（3-6 秒），timeout 设 30 秒

免责声明