Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

AI GatewayにおけるBYOKの意味とは

By アシシュ・ドゥベイ

Updated: 11月 3, 2026

Published: 10月 8, 2026

BYOK(Bring Your Own Key:キーの持ち込み)とは、OpenAI、Anthropic、AWS Bedrockなどのモデルプロバイダーとの独自アカウントを維持したまま、それらのプロバイダーキーをゲートウェイに一度設定することを意味します。アプリケーションが生のプロバイダーキーに直接触れることは二度とありません。アプリは単一のゲートウェイキーを使用して1つのTrueFoundry AI Gatewayエンドポイントと通信し、ゲートウェイが各自の認証情報を用いて各呼び出しを適切なプロバイダーに転送します。

これは、仲介業者からトークンを購入するリセラーモデルとは対照的です。BYOKを利用することで、プロバイダーとの独自の契約、料金体系、レート制限をそのまま維持しながら、その上に一元化されたガバナンスを追加できます。

プロバイダーキーをゲートウェイ経由でルーティングする理由

生のプロバイダーキーをすべてのアプリケーションやノートブックに渡してしまうことが、キーのスプロール(無秩序な拡散)の始まりです。キーがコード内に漏洩したり、環境にコピーされたりして、何かを破損することなくキーを回転(ローテーション)させることが不可能になります。

  • 呼び出し元には1つのキーのみ。 アプリケーションはプロバイダーキーではなく、TrueFoundryキーで認証します。ドキュメントにあるように、ゲートウェイ経由でモデルにアクセスするには、元のプロバイダーキーではなくTrueFoundry APIキーを使用します。
  • 中央での回転(ローテーション)。 プロバイダーキーは1箇所に保存されます。ゲートウェイ側でキーを回転させても、すべてのアプリケーションは正常に動作し続けます。
  • アクセス制御。 アカウントごとの管理者(Manager)およびユーザー(User)ロールにより、誰がどのモデルアカウントを使用できるかを決定できます。
  • 単一のインターフェース。 OpenAI、Anthropic、Bedrock、およびセルフホスト型モデルごとに個別のSDK、エンドポイント、キーを管理する代わりに、アプリケーションは1つのゲートウェイエンドポイントと通信し、1つのゲートウェイキーを使用します。
アプリ全体に分散したプロバイダーキーの管理にお困りですか?
統制された1つのゲートウェイの背後で、チームがどのようにすべてのプロバイダーキーを一元化しているかをご覧ください。お客様のセットアップに合わせてご案内します。

プロバイダーキーの追加:モデルアカウント

TrueFoundryにおいて、プロバイダーキーは「モデルアカウント」内に保存されます。クイックスタートドキュメントでは、モデルアカウントをOpenAI、Anthropic、AWS Bedrockなどのモデルプロバイダーの1つのアカウントとして定義しています。プロバイダーごとに複数のアカウントを追加でき、それぞれが固有のAPIキーを保持し、各アカウントに複数のモデルを持たせることができます。

追加するには、希望するプロバイダーを選択し、APIキーを入力した後にモデルを追加します。別々のモデルアカウントを作成することで、同じプロバイダーから複数のキーを追加できます。これは、環境やチームごとに使用量やレート制限を分離したい場合に便利です。

プロバイダーを選択して独自のAPIキーを追加するAI Gatewayの「Models」ページ。

送信すると、モデルアカウントとモデルが「Models」タブの下に表示されます。後からさらに追加するには、AI Gatewayから「Models」に進み、左側でモデルアカウントを選択して、右上にある「Add Model」をクリックします。

プロバイダーキーの保存後、モデルアカウントにモデルを追加する画面。

呼び出し元の認証方法:バーチャルキー

プロバイダーキーが保存された後は、アプリケーションがそれらを目にすることはありません。ゲートウェイアクセス制御ドキュメントでは、呼び出し元が代わりに使用する2つのトークンタイプについて説明しています。

  • パーソナルアクセストークン(PAT):ユーザーに紐付けられており、開発中のエンジニアに推奨されます。
  • バーチャルアカウントトークン(VAT):仮想アイデンティティに紐付けられており、本番環境のアプリケーションに推奨されます。これはサービスに組み込んで出荷するバーチャルキーです。

アクセス権限はモデルアカウントレベルで2つのロールを用いて設定します。「Model Account Manager」は設定の変更、モデルの追加・削除、アクセス権限の管理が可能です。「Model Account User」はアカウント内のすべてのモデルを使用できますが、設定や権限を変更することはできません。テナント管理者は、プラットフォーム全体のすべてのモデルへのアクセス権を自動的に保持します。

ゲートウェイを呼び出すには、Playgroundの「Code Snippet」タブから、ゲートウェイのベースURL、APIキー、モデルIDの3つを取得する必要があります。SaaSユーザーはゲートウェイのベースURLを指定し、PATまたはVATで認証を行い、標準のOpenAIクライアントを使用します。

‍

アプリケーションが使用するゲートウェイのベースURLとキーを示す、Playgroundの「Code Snippet」タブ。

from openai import OpenAI

アプリに安全に組み込めるバーチャルキーをお求めですか?
お客様のインフラ上で、PAT、VAT、およびアカウントごとのロールの実際の動作をライブデモでご案内します。

キーをゲートウェイに集約することで得られるメリット

  • すべてのプロバイダーおよびすべてのセルフホスト型モデルに対応する、単一のOpenAI互換エンドポイント。
  • アプリケーションコードに触れることのない、中央でのキー回転(ローテーション)。
  • 管理者(Manager)およびユーザー(User)ロールによるアカウントごとのアクセス制御。
  • すべての呼び出しが1箇所を通過することによる、一元化されたオブザーバビリティとポリシーの適用。

あるお客様が語ったように、ゲートウェイの導入によってキーの管理、ルーティングロジック、分散していたオブザーバビリティのオーバーヘッドが解消され、新しいモデルの導入は単なる設定変更のみで行えるようになります。

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
11月 21, 2026
|
5 min read

Microsoft Entra Agent IDによるAI AgentのID管理: エージェントIDの発行と統制

No items found.
11月 21, 2026
|
5 min read

エージェントアイデンティティと代理(OBO)委任:誰が実際にツールを呼び出しているのか?

No items found.
11月 21, 2026
|
5 min read

agentgateway vs Vercel AI Gateway: セルフホスト型エージェントゲートウェイか、マネージド型モデルルーターか?

No items found.
11月 21, 2026
|
5 min read

Linear MCPにおけるAgent Skills:正解率が62%から90%へ向上したベンチマーク

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.

Frequently asked questions

What does BYOK mean for an AI gateway?

BYOK means you keep your own provider accounts and keys and plug them into the gateway once. Applications then call the gateway with a single gateway key, and the gateway uses your stored provider keys to reach OpenAI, Anthropic, Bedrock, and others.

Do my applications ever see the provider key?

No. Callers authenticate with TrueFoundry keys, not the original provider keys. You store the provider key in a model account, and applications use a Personal Access Token or a Virtual Account Token instead.

Can I add more than one key for the same provider?

Yes. You can add multiple accounts per provider, each with their own API keys. This lets you separate spend, rate limits, or environments while keeping a single gateway endpoint.

What is a virtual key?

A Virtual Account Token is tied to a virtual identity rather than a person, which makes it the right choice for production applications. It lets a service authenticate to the gateway without embedding a user credential or a raw provider key.

Take a quick product tour
Start Product Tour
Product Tour