モデルとフォールバック

言語ペアごとにモデルを選び、リクエストを完了できない候補があった場合に、次にどの候補が試されるかを確認します。

ローカライゼーションエンジンのモデル設定では、言語ペアの翻訳にどのモデルを使うか、そのモデルでリクエストを完了できない場合に次に何を試すか、という二つの点を定めます。フォールバックは、実行時の失敗に対処する仕組みです。複数の翻訳を生成し、品質スコアが最も高いものを選ぶ仕組みではありません。

ウェブアプリの作成フォームでは、すべてのロケールペアに推奨のプライマリモデルとフォールバックが既定で設定されます。この幅広い対応範囲をそのまま使うことも、作成時や作成後に、より個別のニーズに合わせて設定することもできます。

モデルと対応範囲を選ぶ #

最新の識別子とコンテキストの上限は、設定画面の対応モデルカタログまたはアカウントのMCPで確認してください。利用できるモデルは変わるため、コピーした一覧は情報が古くなることがあります。Mistral AIのキーを使う場合は、カタログに載っていなくても、そのキーで利用できるチャットモデルを設定画面で選べます。詳しくはカタログにないモデルを参照してください。

正確なモデル識別子を使うと、特定のモデルを指定できます。一方、参照先が変わるエイリアスは、後から別のモデルを指すことがあります。モデルを固定すれば、どのモデルを選んだかを説明しやすくなります。ただし、出力が常に同じになるわけでも、コンテンツへの適合性が保証されるわけでもありません。

ソースとターゲットのロケールペアを設定します。全般に適用する既定の設定にはワイルドカードを使い、別の候補が必要なペアには特定のロケールを指定してください。重要なペアに適用できる設定があるか、必ず確認してください。モデル設定がない場合、再試行しても解決しません。

試行順序を確認する #

ローカライゼーションエンジンは、次の基準を順に使って候補を並べます。

  1. ターゲットロケールの一致レベル。
  2. ソースロケールの一致レベル。
  3. ターゲットロケールの具体性。
  4. ソースロケールの具体性。
  5. 設定された順位。

順位を一位に設定しても、ロケールの一致度が高い候補より優先されるわけではありません。たとえば、英語からde-CHへの翻訳に特化した設定は、汎用的なワイルドカード設定より後に登録されていても、先に試されることがあります。ロケールの解決では、リクエストに適用されるロケール、地域指定のない言語がその言語の既定の地域を表す仕組み、一致レベルに基づく順位付けについて説明しています。

各試行には実行期限があります。ある候補で失敗やタイムアウトが発生すると、次の候補に進むことがあります。候補をすべて試しても完了できなければ、リクエストは失敗します。フォールバックは一つのモデルへの依存を減らしますが、設定にない対応範囲を補うことはできません。また、すべての候補が失敗する状況で成功を保証するものでもありません。

品質と信頼性を分けて比較する #

リクエストの実行記録で、実際に使われたモデルと、フォールバックが発生したかどうかを確認してください。プロバイダーによる拒否、設定エラー、処理は完了していても用途に適さない翻訳では、それぞれ必要な対処が異なります。

組織で用意したキーを使ってプロバイダーのモデルを実行する方法は、BYOKを参照してください。Lingo.devのAPIキーと外部プロバイダーの認証情報は、それぞれ異なるサービスへのアクセスを許可するものです。モデルを選ぶだけでは、認証情報を使った接続は作成されません。

翻訳APIリファレンスでは、JSONコンテンツとコンテキストのフィールドについて説明しています。すべてのジョブにはengineIdが必要です。選択したエンジンが有効で、リクエストする各ロケールペアに対応するモデルが設定されていることを確認してください。各バッチを実際に処理したモデルは、ジョブのモデル試行履歴で確認できます。