語音轉文字

語音轉文字將音訊 URL 轉換為文字和可選的片段元資料。將其用於上傳的音訊、通話錄音、創作者工作流程和後端轉錄作業。

POST /api/open/v1/speech/transcriptions
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json

＃＃要求

{
  "audioUrl": "https://example.com/audio.mp3",
  "language": "en"
}

API 服務必須可存取 audioUrl。如果您的文件是私有的，請產生一個短暫的簽名 URL，該 URL 的有效時間足以進行處理。 language 是可選配的。當您知道原始語言時，請使用語言提示，例如 en、zh 或 ru。

curl https://fishaudio.org/api/open/v1/speech/transcriptions \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audioUrl":"https://example.com/audio.mp3","language":"en"}'

回覆

{
  "text": "This is the transcription result.",
  "duration": 12.4,
  "segments": [],
  "credits_used": 13,
  "quota_remaining": 987987
}

段形狀可能因模型和帳戶功能而異。您的解析器應將段元資料視為可選，並使用 text 作為主要結果。

計費和積分

轉錄通常按音頻時長收費。盡可能驗證您這邊的文件持續時間，尤其是在提交用戶上傳的錄音之前。如果您的產品允許同時上傳多個文件，請將作業排隊並檢查批次之間的帳戶餘額。

當請求在音訊處理開始之前失敗時，製作人員不應被視為與已完成的轉錄相同。使用回應欄位和設定檔檢查來進行操作協調。

錯誤

狀態	意義	行動
`400`	無效的 URL、不支援的音訊或格式錯誤的 JSON	修復請求
`401`	API 金鑰遺失或無效	刷新憑證
`402`	學分或額度不足	停止批次
`422`	音訊可存取但無法處理	詢問使用者不同的檔案
`500`	轉錄服務失敗	如果 URL 仍然有效，使用退避重試

語音轉文字

語音轉文字

回覆

計費和積分

錯誤

本頁內容