テキスト
翻訳の作成
テキストを指定のターゲット言語に翻訳します
概要
テキスト間の翻訳には /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 が指定可能な2つの値のいずれでもありません。param に該当するフィールドが示されます |
400 | unsupported_endpoint | モデルがこのエンドポイントに対応していません |
その他のステータスについては、APIエラーの処理を参照して処理してください。
認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。
指定できる値
- "auto"
- "verified"
- "official"
リクエストボディ
application/json
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json