テキスト

翻訳を作成

テキストを対象言語に翻訳します

POST
/v1/translations

概要

/v1/translations はテキストからテキストへの翻訳に使用します。

この endpoint は 音声翻訳 とは異なります。後者は音声ファイルを受け取り、常に英語テキストを出力します。

agent workflow では、まず現在の推奨翻訳 model を確認してください。

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

そのうえで、選択した model を /v1/translations に明示的に送信します。

recommended_for=translation はテキスト翻訳(POST /v1/translations)にのみ適用され、音声翻訳 には適用されません。

リクエストボディ

modelstring必須

/v1/models?recommended_for=translation が返す翻訳 model ID。

textstring必須

翻訳する元のテキスト。

target_languagestring必須

対象言語コードまたは言語名。model の対応状況によって異なります。

source_languagestring

任意の元言語ヒント。

mime_typestringデフォルト: text/plain

元テキストの形式。サポート値は text/plain と text/html です。

userstring

abuse monitoring と request tracing のための任意の end-user 識別子。

レスポンス

textstring

翻訳後のテキスト。

modelstring

翻訳を生成した model。

source_languagestring | null

model が検出または受理した元言語。

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

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: 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