独自のキーを使用する(BYOK)

組織で保有するAnthropic、OpenAI、Google、Mistral AIのキーを保存すると、そのキーでローカライゼーションのリクエストを実行できます。料金はプロバイダーから直接請求されます。

ローカライゼーションに、組織で保有するモデルプロバイダーのAPIキーを使用できます。設定のBYOKページで組織のキーを追加し、ローカライゼーションに使用するモデルを選択してください。そのプロバイダーのモデルへのリクエストには組織のキーが使われ、トークン料金はプロバイダーから直接請求されます。利用にはEnterpriseプランが必要です。

対応プロバイダー:Anthropic、OpenAI、Google、Mistral AI。

独自のキーでローカライゼーション #

AI評価者やエンジンの提案など、その他の機能には、プロバイダーのキーもモデルの選択も必要ありません。

請求 #

独自のキーでローカライゼーションを実行する場合、モデルのトークン料金はプロバイダーから請求され、Lingo.devからモデル料金が請求されることはありません。ローカライズされたコンテンツに対するLingo.devのインフラストラクチャ料金は、引き続き適用されます。独自のキーを使用しない場合、モデル料金はLingo.devのクレジットから支払われます。

キーを管理できるユーザー #

BYOKページの利用は、次の二つの条件で制御されます。

  1. 利用資格:組織でBYOK機能が有効になっている必要があります(Enterpriseプラン)。このページは、利用資格の有無にかかわらず設定に表示されます。利用資格がない場合は「ご利用のプランでは独自のプロバイダーキーを使用できません」と表示され、キーを保存できません。
  2. 権限:キーの追加、置き換え、オンとオフの切り替え、削除には、メンバーのロールに設定の管理(org:manage_settings)権限が必要です。ロールベースのアクセス制御を使用していない場合、すべてのメンバーがオーナーとなり、この権限を持ちます。

すべてのメンバーが、どのプロバイダーにキーが登録されているか、そのキーが使用中かどうかを確認できます。組織のAPIキーではキーを変更できません。個人のアカウントでログインしてください。

キーの追加 #

  1. 設定 → BYOKを開きます。
  2. プロバイダーの横にあるキーを追加をクリックします。
  3. APIキーを貼り付けて保存します。

保存時に、Lingo.devがプロバイダーにキーの有効性を確認します。プロバイダーがキーを受け付けない場合、キーは保存されません。プロバイダーのアカウントでキーを確認し、もう一度貼り付けてください。

キーの表示

保存したキーの全体が再表示されることはありません。ページには末尾の四文字と更新日時のみが表示されます。変更するには、置き換えを選択して新しいキーを貼り付けてください。

プロバイダーのモデルを使用する #

ローカライゼーションのリクエストでそのプロバイダーのモデルを呼び出すと、独自のキーが使用されます。エンジンのローカライゼーションステップで独自のキーを使用するには、エンジンのモデル設定で、そのプロバイダーのモデルを指定してください。

状況動作
モデルの提供元プロバイダーのキーが登録されていて、オンになっており、そのキーでモデルを利用できる独自のキーでリクエストが実行される
そのプロバイダーのキーがないカタログ内のモデルによるローカライゼーションには、Lingo.devのクレジットが使用される
キーがオフになっているカタログ内のモデルによるローカライゼーションには、Lingo.devのクレジットが使用される
モデルがLingo.devのモデルカタログになく、そのプロバイダーの独自のキーが未登録またはオフになっているLingo.devのキーではそのモデルを利用できないため、ローカライゼーションが失敗する
独自のキーでのモデルの利用をプロバイダーが拒否するカタログ内のモデルはLingo.devのクレジットで再試行され、カタログ外のモデルは実行に失敗する

BYOKタグ

独自のキーが使われるのは、エンジンに設定した識別子と完全に一致する識別子で、プロバイダーがそのモデルを提供している場合に限られます。モデル選択画面とエンジンのモデル設定では、独自のキーで利用できるモデルにBYOKタグが付きます。保存したモデルにBYOK対象外タグが付いている場合、そのモデルは独自のキーでは利用できないため、ローカライゼーションにはLingo.devのクレジットが使用されます。保存したモデルにMistral AIのキーが必要タグが付いている場合、そのモデルはLingo.devのモデルカタログになく、独自のMistral AIキーでのみ実行できますが、そのキーが未登録またはオフになっています。キーを追加するかオンに切り替えるか、別のモデルを選択してください。

キーが未登録またはオフになっていても、カタログ内のモデルによるローカライゼーションが停止することはありません。

カタログ外のモデル #

モデル選択画面では、mistralai/zai-glm-5-3など、独自のMistral AIキーで利用できるものの、Lingo.devのモデルカタログにはないチャットモデルも選択できます。これらにはBYOKタグが付き、Mistral AIが定めた識別子を使って、モデルごとに一つずつprovider/modelとして表示されます。mistralai/zai-glm-latestなどの別名で保存したモデルも、独自のキーで実行されます。

これらのモデルはLingo.devのキーでは利用できないため、独自のキーでのみ実行されます。現時点では、どれがチャットモデルかを示しているのはMistral AIのモデル一覧だけです。そのため、他のプロバイダーのキーを追加しても、カタログ外のモデルは追加されません。

独自のキーが拒否された場合 #

以下のエラーが発生すると、ローカライゼーションのリクエストは停止します。Lingo.devのクレジットでの再試行や、エンジンのモデル設定にある次のモデルへの切り替えは行われません。エラーには、プロバイダー名と対処が必要な内容が表示されます。

状況対処方法
プロバイダー側でキーのレート制限に達している数分後に再試行するか、プロバイダー側でキーのレート上限を引き上げる
プロバイダーのアカウントでクレジットまたは利用枠を使い切っているプロバイダー側でクレジットを追加するか利用枠を引き上げてから、再試行する
失効などの理由で、プロバイダーがキーを拒否している設定 → BYOKでキーを置き換えてから、再試行する
Lingo.devが保存済みのキーを読み取れない設定 → BYOKでキーをもう一度保存してから、再試行する

これらは組織側の利用上限やアカウントに関する問題です。Lingo.devのクレジットで再試行すると、問題に気付けなくなってしまいます。

キーをオフにする #

キーを削除せずに使用を停止するには、キーをオフにします。ページにはオフと表示され、再びオンにするまで、そのプロバイダーのカタログ内のモデルによるローカライゼーションにはLingo.devのクレジットが使用されます。キーがオフの間、カタログ外のモデルは実行されません。

ご利用のプランで独自のキーを使用できなくなると、保存済みのキーには保存済み、使用していませんと表示されます。そのプロバイダーのカタログ内のモデルによるローカライゼーションにはLingo.devのクレジットが使用され、カタログ外のモデルは実行されません。保存済みのキーは、削除するまで保持されます。

キーの削除 #

キーを削除をクリックすると、Lingo.devからキーが削除されます。そのプロバイダーのカタログ内のモデルによるローカライゼーションでは、再びLingo.devのクレジットが使用されるようになり、カタログ外のモデルは実行されなくなります。

プロバイダー側でキーを失効させる

Lingo.devからキーを削除しても、キー自体は失効しません。プロバイダー側で失効させるまで、キーは有効なままです。