TokenLab

音訊與即時

建立翻譯

將音訊翻譯為英文文字

POST
/v1/audio/translations

概觀

將任何支援語言的音訊翻譯為英文文字。與轉錄不同,無論輸入語言為何,此端點一律輸出英文文字。

此端點會將音訊翻譯為英文。請勿傳送 language;音訊翻譯不支援此參數,且可能會傳回 unsupported_parameter。如需文字翻譯,請使用 POST /v1/translations;recommended_for=translation 是指該文字 API。

請求內文

翻譯會在處理完成時傳回。針對較長的音訊,請設定至少 120s 的 HTTP 客戶端逾時時間。

filefile必填

要翻譯的音訊檔案。支援的格式:flac、mp3、mp4、mpeg、mpga、m4a、ogg、wav、webm。檔案大小上限為 25 MB。

modelstring必填

目前沒有公開模型宣告支援 POST /v1/audio/translations;目前沒有預設或可複製的模型 ID。

promptstring

用於引導模型風格或接續前一個片段的選填文字。應使用英文。

response_formatstring預設值: json

輸出格式。可接受的值取決於模型;請查看其詳細資訊。text 會傳回原始文字而非 JSON 物件。

temperaturenumber

採樣溫度,介於 0 到 1 之間,僅適用於有列出此參數的模型。

回應

以下欄位說明 JSON 轉錄或翻譯回應。text、srt 和 vtt 會傳回原始文字或字幕,而非 JSON 物件。其他欄位則取決於模型和輸出格式。

textstring

翻譯後的英文文字。

若使用 verbose_json 格式,回應還包含:

languagestring

回應中所報告的語言標籤(如有提供)。

durationnumber

輸入音訊的時長(以秒為單位)。

segmentsarray

帶有時間戳記的翻譯文字片段。

請求

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-model-id" \
  -F "file=@german_audio.mp3"

回應

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

翻譯與轉錄比較

功能翻譯轉錄
輸出語言一律為英文與輸入相同
使用案例將外語音訊轉換為英文保留原始語言
語言參數不適用選填提示

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

請求標頭

X-TokenLab-Delivery-Policy?string

單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。

可選值

  • "auto"
  • "verified"
  • "official"

請求主體

multipart/form-data

回應

application/json

application/json

application/json

application/json

application/json

application/json