Fish Audio 文档
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。languageignore_timestampsfile_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 作为主要结果,并允许分段信息为空。

错误

状态码含义建议
400URL、音频格式或 JSON 无效修正请求
401API Key 缺失或无效更新凭据
402API 额度不足停止批次并提示充值
422音频可访问但无法处理更换音频文件
500转写服务失败URL 仍有效时使用退避重试

本页内容