API 文档语音转文字
语音转文字
通过 Open API 转写音频。
该接口同步接收可公开访问的音频 URL,并返回转写文本和可选的分段信息。
POST /api/open/v1/speech/transcriptions
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json请求
{
"audio_url": "https://example.com/audio.mp3",
"language": "zh",
"ignore_timestamps": false
}audio_url 必填,服务端必须能够直接访问。私有文件应使用在处理期间保持有效的短期签名 URL。language、ignore_timestamps 和 file_name 均为可选字段。下载后的音频最大为 50 MB。
curl https://fishaudio.org/api/open/v1/speech/transcriptions \
-H "Authorization: Bearer FISHAUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url":"https://example.com/audio.mp3","language":"zh"}'响应
{
"text": "这是转写结果。",
"duration": 12.4,
"segments": [],
"credits_used": 13,
"quota_remaining": 987987
}segments 的内容可能因模型而异,客户端应将 text 作为主要结果,并允许分段信息为空。
错误
| 状态码 | 含义 | 建议 |
|---|---|---|
400 | URL、音频格式或 JSON 无效 | 修正请求 |
401 | API Key 缺失或无效 | 更新凭据 |
402 | API 额度不足 | 停止批次并提示充值 |
422 | 音频可访问但无法处理 | 更换音频文件 |
500 | 转写服务失败 | URL 仍有效时使用退避重试 |