Skip to main content
BYOK は現在開発中です。ベータへの参加は support@arouter.ai までご連絡ください。
Bring Your Own Key(BYOK)を使用すると、ARouter に自分のプロバイダー API キーを登録できます。登録済みキーのあるプロバイダーにリクエストがルーティングされると、ARouter は共有キープールではなくあなたのキーを使用します。 メリット:
  • ゼロ上乗せ — トークンコストの上乗せなし、プロバイダーの定価で直接支払い
  • 独自のクォータ — リクエストは ARouter の共有プールではなく、自分のプロバイダーレート制限に対してカウント
  • 独自のデータポリシー — 既存のプロバイダー契約とデータ条件が適用
  • 統合ゲートウェイ — 引き続き ARouter のルーティング、フォールバック、オブザーバビリティを上層で活用

BYOK の仕組み

  1. ARouter ダッシュボードでプロバイダー API キーを登録
  2. ARouter がそのプロバイダーにリクエストをルーティングする際、あなたのキーに置き換える
  3. アカウントにトークンコストは請求されない(ARouter サービス料金のみ、該当する場合)
  4. レスポンスに usage.is_byok: true が返される

キーの登録

ARouter ダッシュボード でプロバイダーキーを追加します。 サポートされるプロバイダーとキー形式:

BYOK とプロバイダー順序の組み合わせ

BYOK と provider.order を組み合わせて、キーがいつ使用されるかを制御します:
OpenAI が順序リストにあり、OpenAI BYOK キーが登録されている場合、ARouter はそのプロバイダーに対して自動的にあなたのキーを使用します。

部分的 BYOK

一部のプロバイダーにキーを登録しながら、その他は ARouter の共有プールを使用できます:
Anthropic の BYOK キーがある場合、Anthropic にあなたのキーで最初に試みます。AWS Bedrock キーがあれば次に試みます。それ以外は ARouter が共有プールにフォールバックします。

Azure OpenAI

Azure OpenAI エンドポイントとキーを登録します:
そこへルーティングします:

AWS Bedrock

2 つの認証オプション: オプション 1:Bedrock API キー(推奨)
オプション 2:AWS 認証情報

Google Vertex AI


BYOK リクエストの識別

あなたのキーが使用された場合、レスポンスの usage オブジェクトに is_byok: true が含まれます:
is_byok: true の場合、usage.cost はあなたの直接プロバイダーコスト(ARouter 上乗せなし)を反映します。

キーの優先度とフォールバック


BYOK の問題のデバッグ

ダッシュボードのアクティビティページで各リクエストに使用されたキーを確認できます。よくあるエラー: