音訊與即時
建立翻譯
將音訊翻譯為英文文字
概觀
將任何支援語言的音訊翻譯為英文文字。與轉錄不同,無論輸入語言為何,此端點一律輸出英文文字。
此端點會將音訊翻譯為英文。請勿傳送 language;音訊翻譯不支援此參數,且可能會傳回 unsupported_parameter。如需文字翻譯,請使用 POST /v1/translations;recommended_for=translation 是指該文字 API。
請求內文
翻譯會在處理完成時傳回。針對較長的音訊,請設定至少 120s 的 HTTP 客戶端逾時時間。
要翻譯的音訊檔案。支援的格式:flac、mp3、mp4、mpeg、mpga、m4a、ogg、wav、webm。檔案大小上限為 25 MB。
目前沒有公開模型宣告支援 POST /v1/audio/translations;目前沒有預設或可複製的模型 ID。
用於引導模型風格或接續前一個片段的選填文字。應使用英文。
json輸出格式。可接受的值取決於模型;請查看其詳細資訊。text 會傳回原始文字而非 JSON 物件。
採樣溫度,介於 0 到 1 之間,僅適用於有列出此參數的模型。
回應
以下欄位說明 JSON 轉錄或翻譯回應。text、srt 和 vtt 會傳回原始文字或字幕,而非 JSON 物件。其他欄位則取決於模型和輸出格式。
翻譯後的英文文字。
若使用 verbose_json 格式,回應還包含:
回應中所報告的語言標籤(如有提供)。
輸入音訊的時長(以秒為單位)。
帶有時間戳記的翻譯文字片段。
請求
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 API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。
可選值
- "auto"
- "verified"
- "official"
請求主體
multipart/form-data
回應
application/json
application/json
application/json
application/json
application/json
application/json