Otterai API 不支持官方 PHP SDK，但可通过 cURL 调用其 REST 接口；需正确设置 Authorization 头、multipart 上传、language 小写参数（如 zh）、支持格式（MP3/WAV/FLAC/OGG），并处理异步轮询与错误码。
Otterai API 是否支持 PHP 直接调用
不支持官方 SDK，但可通过标准 HTTP 请求调用其 REST API。Otterai 的语音识别接口（/v1/transcribe）接受音频文件上传或 URL，返回 JSON 格式结果，PHP 完全能胜任——关键在于正确构造请求头、处理 multipart/form-data 上传、以及解析响应。
注意：Otterai 要求请求带 Authorization: Bearer {token}，且目前仅支持 en、ja、ko、zh 等有限语种，传错 language 参数会导致静音或乱码，不是所有“多语言”都可用。
PHP 用 cURL 上传本地音频并指定语言
必须用 curl_setopt($ch, CURLOPT_POSTFIELDS, $data) 发送二进制音频，不能用 json_encode() 包裹；语言通过 language 字段传（非 lang 或 locale），值必须小写且在 Otterai 支持列表内。
-
audio字段需用CURLFile（PHP ≥ 5.5）或手动构造 boundary（PHP - 推荐设
Content-Type: multipart/form-data由 cURL 自动处理，别手动拼 - 超时建议设为
120秒以上——1 分钟音频上传+识别常需 40–90 秒 - 示例关键片段：
$data = [ 'audio' => new CURLFile('/path/to/audio.mp3'), 'language' => 'zh' ]; curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
常见报错及对应修复
401 Unauthorized：Token 过期或未绑定有效订阅，检查 Otterai 控制台的 API Keys 页面是否启用；400 Bad Request 多因 language 值非法（如传 zh-CN 而非 zh）或音频格式不被支持（Otterai 明确不支持 OPUS、M4A，只认 MP3、WAV、FLAC、OGG）。
立即学习“PHP免费学习笔记（深入）”；
-
Empty response或JSON decode error：大概率是返回了 HTML 错误页（如 429），加curl_setopt($ch, CURLOPT_HEADER, true)查看完整响应头和体 -
SSL certificate problem：开发环境可临时加curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)，但上线前必须恢复并配置 CA 证书路径 - 中文识别结果含大量英文词：确认
language=zh已传入，且音频采样率 ≥ 16kHz，低于 8kHz 的录音基本无法识别中文
异步识别与轮询结果的可靠性处理
Otterai 的 /v1/transcribe 默认同步返回，但大文件会超时；更稳的做法是先发 POST /v1/transcribe?async=true 拿到 job_id，再用 GET /v1/jobs/{job_id} 轮询，直到 status === "completed"。
轮询时务必加退避：首次 1 秒后查，失败则 2 秒、4 秒、8 秒……最大间隔不超过 30 秒；连续 5 次 status === "failed" 就该停，检查音频是否静音或格式损坏——这个逻辑很容易被忽略，直接 while(true) 会触发限流。
