メインコンテンツへスキップ

​
概要

/v1/translations はテキストからテキストへの翻訳に使用します。
この endpoint は 音声翻訳 とは異なります。音声ファイルを受け取り、常に英語テキストを出力します。
agent workflow では、まず現在の推奨翻訳 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
abuse monitoring と request tracing のための任意の end-user 識別子。

​
レスポンス

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