文本
创建翻译
将文本翻译为目标语言
概述
使用 /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"
}错误
| 状态码 | 代码 | 原因 |
|---|---|---|
400 | invalid_request | 缺少 model、text 或 target_language,或为空,或 mime_type 不是两个取值之一,param 指出该字段 |
400 | unsupported_endpoint | 该模型未开放此端点 |
其他状态码的处理见处理 API 错误。
授权
BearerAuth API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
请求头
单次请求的交付策略。覆盖 API 密钥和 Workspace 的默认设置。自动优先尝试 TokenLab Verified,并在输出、请求接受或持久资源创建之前,可能会切换一次至仅限 Official。
可选值
- "auto"
- "verified"
- "official"
请求体
application/json
响应
application/json
application/json
application/json
application/json
application/json
application/json