文本

创建翻译

将文本翻译为目标语言

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

错误

状态码代码原因
400invalid_request缺少 model、text 或 target_language,或为空,或 mime_type 不是两个取值之一,param 指出该字段
400unsupported_endpoint该模型未开放此端点

其他状态码的处理见处理 API 错误。

授权

BearerAuth
AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

请求头

X-TokenLab-Delivery-Policy?string

单次请求的交付策略。覆盖 API 密钥和 Workspace 的默认设置。自动优先尝试 TokenLab Verified,并在输出、请求接受或持久资源创建之前,可能会切换一次至仅限 Official。

可选值

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

请求体

application/json

响应

application/json

application/json

application/json

application/json

application/json

application/json