PHP调用Otterai多语言语音识别【方法】-php教程-PHP中文网

Otterai API 不支持官方 PHP SDK，但可通过 cURL 调用其 REST 接口；需正确设置 Authorization 头、multipart 上传、language 小写参数（如 zh）、支持格式（MP3/WAV/FLAC/OGG），并处理异步轮询与错误码。

php调用otterai多语言语音识别【方法】

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）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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) 会触发限流。