文字
建立翻譯
將文字翻譯為目標語言
概覽
使用 /v1/translations 進行文字對文字翻譯。
此端點與語音翻譯不同,後者接受音訊檔案且一律輸出英文文字。
使用 Models API 取得目前的文字翻譯模型:
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"然後將所選的模型明確傳送至 /v1/translations。
recommended_for=translation 僅適用於文字翻譯(POST /v1/translations),不適用於語音翻譯。
請求主體
由 /v1/models?recommended_for=translation 返回的翻譯模型 ID。
要翻譯的來源文字。輸入長度限制取決於模型;請參閱 GET /v1/models/{model} 中的 max_input_tokens。
目標語言代碼或語言名稱,取決於模型支援情況。
選填的來源語言提示。
text/plain來源文字格式:text/plain 或 text/html。僅在模型詳細資訊中列出 mime_type 時傳送。
選填的終端使用者識別碼,用於濫用監控與請求追蹤。僅在模型詳細資訊中列出 user 時傳送。
回應
翻譯後的文字。
產生翻譯的模型。
模型偵測到或接受的來源語言。
請求中使用的目標語言。
請求
curl -X POST "https://api.tokenlab.sh/v1/translations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-translation",
"text": "你好,欢迎使用 TokenLab。",
"target_language": "en"
}'回應
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}錯誤
| Status | Code | Cause |
|---|---|---|
400 | invalid_request | model、text 或 target_language 缺失或為空,或者 mime_type 不是這兩個值之一。param 指明該欄位 |
400 | unsupported_endpoint | 該模型未針對此端點發布 |
其他狀態的處理方式請參閱處理 API 錯誤。
授權
BearerAuth API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。
可選值
- "auto"
- "verified"
- "official"
請求主體
application/json
回應
application/json
application/json
application/json
application/json
application/json
application/json