テキスト

翻訳の作成

テキストを指定のターゲット言語に翻訳します

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_requestmodel、text、または target_language が不足しているか空であるか、mime_type が指定可能な2つの値のいずれでもありません。param に該当するフィールドが示されます
400unsupported_endpointモデルがこのエンドポイントに対応していません

その他のステータスについては、APIエラーの処理を参照して処理してください。

認証

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