TokenLab

文字

建立翻譯

將文字翻譯為目標語言

POST
/v1/translations

概覽

使用 /v1/translations 進行文字對文字翻譯。

此端點與語音翻譯不同,後者接受音訊檔案且一律輸出英文文字。

使用 Models API 取得目前的文字翻譯模型:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

然後將所選的模型明確傳送至 /v1/translations。

recommended_for=translation 僅適用於文字翻譯(POST /v1/translations),不適用於語音翻譯。

請求主體

modelstring必填

由 /v1/models?recommended_for=translation 返回的翻譯模型 ID。

textstring必填

要翻譯的來源文字。輸入長度限制取決於模型;請參閱 GET /v1/models/{model} 中的 max_input_tokens。

target_languagestring必填

目標語言代碼或語言名稱,取決於模型支援情況。

source_languagestring

選填的來源語言提示。

mime_typestring預設值: text/plain

來源文字格式:text/plain 或 text/html。僅在模型詳細資訊中列出 mime_type 時傳送。

userstring

選填的終端使用者識別碼,用於濫用監控與請求追蹤。僅在模型詳細資訊中列出 user 時傳送。

回應

textstring

翻譯後的文字。

modelstring

產生翻譯的模型。

source_languagestring | null

模型偵測到或接受的來源語言。

target_languagestring

請求中使用的目標語言。

請求

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"
  }'

回應

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

錯誤

StatusCodeCause
400invalid_requestmodel、text 或 target_language 缺失或為空,或者 mime_type 不是這兩個值之一。param 指明該欄位
400unsupported_endpoint該模型未針對此端點發布

其他狀態的處理方式請參閱處理 API 錯誤。

授權

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"

請求主體

application/json

回應

application/json

application/json

application/json

application/json

application/json

application/json