⊕⊕

开发者工作区

管理 API Key，并使用当前套餐可调用的 MITTS 音色与语言编号接入语音合成。

语音工作台使用历史

KAPI KEYS

0 个可用

正在加载...

已撤销或停用的 Key 可从列表删除；历史用量与调用审计会保留。

R调用规则

基础会员10 RPM / 1 并发
进阶会员30 RPM / 2 并发
企业会员60 RPM / 4 并发

API 与网页合成共享字符额度。每次请求必须携带唯一的 Idempotency-Key。

A合成接口

POST /v1/audio/speech

使用 Bearer API Key 鉴权。成功时直接返回音频；相同幂等键和请求内容将重放已生成结果。

curl -X POST https://mitts.lss.lol/v1/audio/speech \
  -H "Authorization: Bearer mitts_你的APIKey" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "你好，欢迎使用 MITTS 语音合成服务。",
    "voice": "d0001",
    "language": "zh_cn",
    "response_format": "mp3"
  }' \
  --output speech.mp3
input必填，待合成文本。
voice必填，MITTS 音色 ID。
language必填，MITTS 语言 ID。
response_format可选：mp3、wav、ogg-opus。

1接入步骤

  1. 创建 API Key在本页创建并立即保存。完整 Key 只显示一次。
  2. 查询可用编号在下方当前可用目录查询音色 ID 与语言 ID，或使用任一有效 Key 请求 GET /v1/voices。
  3. 读取额度请求 GET /v1/account 获取当前套餐的单次上限与剩余字符额度。
  4. 生成幂等键每个新任务创建一个 UUID，并在网络重试同一任务时复用它。
  5. 发送合成请求调用 POST /v1/audio/speech，成功时直接保存响应音频。

IIdempotency-Key

这是防止重复扣费和重复合成的请求编号。新任务使用新 UUID，重试同一任务复用原 UUID。 不要固定写一个值，也不要把一个值用于不同文本、音色或参数。

Node.js: crypto.randomUUID()
Python:  str(uuid.uuid4())
PowerShell: [guid]::NewGuid().ToString()

若请求超时，先使用原 Key 原样重试；服务会返回先前结果或处理中状态，不会再次合成。

D请求与响应参考

请求头

字段是否必填说明
Authorization必填Bearer mitts_...
Idempotency-Key必填当前任务的 UUID，最长 128 字符。
Content-Type必填application/json

JSON 参数

字段类型必填说明
inputstring是待合成文本。
voicestring是MITTS 音色 ID，例如 d0001。
languagestring是MITTS 语言 ID，例如 zh_cn。
response_formatstring否mp3、wav 或 ogg-opus，默认 mp3。
speednumber否0.5 至 2，默认 1。
volumenumber否0.5 至 2，默认 1。
pitchnumber否-20 至 20，默认 0。

响应与重试

成功响应为音频二进制数据。建议将响应保存为所请求格式的文件。失败时返回 JSON 格式的 error.code。

400 参数、音色或语言编号错误。401 API Key 缺失、无效或已失效。403 套餐权限或字符额度不足。409 相同幂等键正在处理，稍后使用原 Key 重试。429 频率或并发超限，按 Retry-After 等待。502 合成服务暂时失败，使用新的 Key 发起新任务。

V可用音色与语言

0 个音色 / 0 种语言

目录仅展示当前账户 API Key 可调用的组合；使用任一有效 Key 请求 GET /v1/voices 将返回同一范围。

正在加载可用音色...

联系反馈