跳过主要内容
MAI Transcribe 2 logoMAI Transcribe 2

MAI Transcribe 2 语音转文字 API

在账户里生成 API Key，然后把音频 POST 到本站。免费档不能调 API。成功任务和网页共用 Credit：1 Credit ≈ 1 分钟，四舍五入，每次至少 1 Credit。

如何调用

带上 Bearer Token 和 multipart 文件。请附上时长（秒），我们会在调用模型前检查余额。可选 mode：verbatim（默认，原话）或 smart（可读）。可选 phrases：逗号或换行分隔，最多 100 个术语。失败不扣 Credit。

POST https://maitranscribe2.com/api/v1/transcribe

生成 API Key

请求示例

curl -X POST https://maitranscribe2.com/api/v1/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@interview.m4a" \
  -F "duration=182" \
  -F "mode=verbatim" \
  -F "phrases=Lisinopril,Pharmacy Support"

成功返回

HTTP 200，JSON。text 是全文。segments 是带时间的句子，可能有 speaker。mode 回显 verbatim 或 smart。credits_used 和 credits_remaining 是这次之后的钱包。

{
  "ok": true,
  "text": "我们从三季度预算复盘开始。",
  "segments": [
    { "start": 6.0, "end": 12.4, "text": "我们从三季度预算复盘开始。", "speaker": "Daniel" }
  ],
  "mode": "verbatim",
  "credits_used": 3,
  "credits_remaining": 297
}

错误码

401 auth

缺少或无效的 API Key。到设置 → API keys 再生成一把。

403 plan

免费账户不能调 API。买 Plus、Pro 或任意积分包。

402 credits

Credit 不够。JSON 里有 credits_needed 和 credits_remaining。

400 validation

没文件、没时长、格式不支持，或超过套餐大小/时长。用 MP3、WAV、M4A、FLAC 或 MP4。

502 / 503 upstream

模型没返回文本，或上游不可用。未扣 Credit。请退避重试。

限额、重试和计费

文件和 Credit 限额

和网站相同：Plus 30 分钟 / 50 MB，Pro 60 分钟 / 50 MB。吞吐受剩余 Credit 限制，没有另发一份 QPS。没有沙箱地址，请用小文件打生产。

重试

502/503 用指数退避（1s、2s、4s）。401 或 403 先修好密钥或套餐再试。402 需要更多 Credit。没有幂等键；第二次成功的 POST 会再扣一次。

计费

只有返回转写后才扣 Credit。网站和 API 共用钱包。订阅 Credit 按账期重置；积分包不过期。

密钥安全

把 Key 当密码。泄露就轮换。不要提交到仓库。认证只看 Bearer Token；这是服务端到服务端的 API，CORS 允许任意 Origin。