跳转到主要内容

​
概览

使用 /v1/translations 进行文本到文本翻译。
这个 endpoint 与 音频翻译 不同，后者接收音频文件，并且始终输出英文文本。
对于 agent 工作流，建议先查找当前推荐的翻译 model： 
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" \
  -H "Authorization: Bearer sk-your-api-key"
然后将选定的 model 明确传给 /v1/translations。
recommended_for=translation 只适用于文本翻译（POST /v1/translations），不适用于 音频翻译。

​
请求体

​
model
string
必填
由 /v1/models?recommended_for=translation 返回的翻译 model ID。
​
text
string
必填
要翻译的源文本。
​
target_language
string
必填
目标语言代码或语言名称，具体取决于 model 支持情况。
​
source_language
string
可选的源语言提示。
​
mime_type
string
默认值:"text/plain"
源文本格式。支持值：text/plain、text/html。
​
user
string
可选的最终用户标识，用于滥用监控和请求追踪。

​
响应

​
text
string
翻译后的文本。
​
model
string
生成翻译结果的 model。
​
source_language
string | null
model 检测到或接受的源语言。
​
target_language
string
本次请求使用的目标语言。
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"
  }'

from openai import OpenAI
import requests

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

response = requests.post(
    "https://api.tokenlab.sh/v1/translations",
    headers={
        "Authorization": "Bearer sk-your-api-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "doubao-seed-translation",
        "text": "你好，欢迎使用 TokenLab。",
        "target_language": "en",
    },
    timeout=30,
)

print(response.json()["text"])

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