Gate.AIの統合方法：開発者向けクイックスタート

Gate.AI API 統合により、開発者は OpenAI 互換の API を通じてさまざまな AI モデルにアクセスでき、統一されたモデル接続、ルーティング、テストを実現します。各モデルサービスプロバイダーごとに SDK 設定を個別に管理する必要はありません。チャットボット、内部ツール、インテリジェントエージェント、フロー自動化、モデル評価スクリプトなどの開発において、導入プロセスを大幅に簡素化します。本ガイドでは、API キー作成、オートルーティング、手動モデル選択、OpenAI 互換の基本 URL、最初のリクエストテスト、一般的な設定エラーのトラブルシューティングについて説明します。ただし、エンタープライズガバナンス、課金戦略設計、カスタムセキュリティアーキテクチャなどの高度なトピックは含みません。

前提条件：

• Gate.AI アカウントを所有し、コンソール設定にアクセス可能
• ローカル環境に Python、Node.js、または curl が設定済み

このガイドを完了するとどのような能力が得られますか？

このガイドを完了すると、Gate.AI API キーの作成、OpenAI 互換の基本 URL の設定、model: "auto" を使った最初の API リクエストの送信、指定モデル ID のテストができるようになります。

開発者は Gate.AI API 統合を通じてどのようなアプリケーションを構築できますか？

開発者は Gate.AI API を利用し、統一された OpenAI 互換リクエストフォーマットを通じて複数モデル体系にアクセス可能です。代表的な用途例は以下の通りです。

| 構築タイプ | Gate.AI の役割 | 例示出力 | | ------------------ | ------------------------------------- | ------------------------------ | | チャットアプリ | ユーザーメッセージを対応モデルにルーティング | カスタマーサポートアシスタント | | 内部ツール | チーム間での API 統一設定 | AI ライティング/リサーチアシスタント | | インテリジェントエージェントとフロー | モデル呼び出しとタスク自動化 | ツール呼び出しアシスタント | | モデルテスト | auto ルーティングと固定モデル ID の比較 | 評価スクリプト | | 移行プロジェクト | 既存の OpenAI 互換基本 URL の置換 | マルチモデルプロトタイプ |

Gate.AI にモデルを自動選択させたい場合は、model: "auto" を使用します。特定のモデルの再現性を持たせたい場合は、具体的なモデル ID を記入してください。

事前に準備すべきものは何ですか？

開始前に満たすべき2つの重要条件：

| 必要条件 | 重要な理由 | | ------------------ | ----------------------------------------------------- | | Gate.AI アカウントアクセス | コンソールから API キー作成とルーティング設定確認のため | | ローカルリクエスト手段 | Python、Node.js、または curl でテストリクエスト送信のため |

すべてのモデルを最初から選択する必要はありません。API キーと基本 URL の有効性を確認し、手動モデル選択をテストしてください。

ステップ 1：Gate.AI API キーの作成

このステップでは、API 認証用の資格情報を作成します。

操作手順：

1. gate.ai にアクセス
2. ログイン方法を選択し認証を完了
3. Console → 設定 → API キーを開く
4. 「作成」ボタンをクリック
5. すぐに API キーをコピーし、安全に保存

API キーエリアに新しいキーが表示されます。secret は一度だけ表示されるため、作成ウィンドウを閉じる前に必ずコピーしてください。

ステップ 2：自動ルーティングまたは手動モデル選択の設定

このステップでは、Gate.AI にモデルを自動割り当てさせるか、リクエスト時に指定するかを決定します。

操作手順：

1. Console → 設定 → ルーティングを開く
2. 「自動ルーティング」スイッチを確認
3. Gate.AI にリクエストごとに自動モデル選択させたい場合は、スイッチをオンのままに
4. 特定のモデル ID を手動で指定したい場合は、自動ルーティングをオフにし、リクエストボディにモデル ID を記入

| 選択モード | リクエストパラメータ値 | 適用シーン | | ------------------ | ---------------------------------------- | ---------------------------------------- | | 自動ルーティング | "model": "auto" | Gate.AI に自動ルーティングさせたい場合 | | 手動モデル選択 | "model": "anthropic/claude-sonnet-4.6" | テストや特定モデルを使いたい場合 |

自動ルーティングは素早い導入と汎用ルーティングテストに適します。手動選択は、特定モデルの再現性評価に向いています。

ステップ 3：OpenAI 互換の基本 URL の設定

このステップでは、既存の OpenAI スタイルのクライアントを Gate.AI に向け、OpenAI のデフォルトエンドポイントではなくします。

以下の基本 URL を使用してください。

text

認証フォーマットは以下の通り：

text Authorization: Bearer YOUR_API_KEY

Gate.AI のドキュメントでは、API パスは /openai/v1 であり、単に /v1 ではありません（2026年6月現在）。例に従い、完全な基本 URL を正確に記入してください。

| 設定項目 | 値 | | ------------------ | ------------------------------------------ | | 基本 URL | | | 認証方式 | Authorization: Bearer YOUR_API_KEY | | フォーマット | OpenAI 互換 | | チャットエンドポイント | POST /chat/completions | | モデル一覧エンドポイント | GET /models |

多くの設定ミスは、基本 URL の省略や API キーのコピー間違いに起因します。これらをまず確認し、その後モデル設定を調整してください。

ステップ 4：最初の API リクエスト送信

このステップは、API キー、基本 URL、OpenAI 互換チャットフォーマットの連携動作をテストします。

Python の例：

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="auto", messages=[ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Say hello from Gate.AI."} ], )

print(completion.choices[0].message.content)

Node.js の例：

javascript import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "", });

const completion = await client.chat.completions.create({ model: "auto", messages: [ { role: "system", content: "You are a concise assistant." }, { role: "user", content: "Say hello from Gate.AI." } ], });

console.log(completion.choices[0].message.content);

curl の例：

bash curl /chat/completions
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{ "model": "auto", "messages": [ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Say hello from Gate.AI."} ] }'

正常なアシスタントの応答が返るはずです。認証エラーが出た場合は、まず API キーを確認してください。コードの修正は不要です。

ステップ 5：指定モデル ID のテスト

このステップでは、特定のモデルを指定する必要がある場合に、手動モデル選択が有効かどうかを検証します。

model パラメータを auto から、サポートされている具体的なモデル ID に変更します。

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="anthropic/claude-sonnet-4.6", messages=[ {"role": "user", "content": "Explain model routing in one paragraph."} ], )

print(completion.choices[0].message.content)

モデル ID は、Gate.AI のモデルドキュメントやモデルリストに記載された名称を厳守してください。スペルミスがあると、API キーや基本 URL が正しくてもリクエストは失敗します。

Gate.AI API のリクエストにおける自動ルーティングの仕組みはどう動作しますか？

Gate.AI の自動ルーティングは、リクエストボディに model: "auto" を記入し、Gate.AI コンソールのルーティング設定と連携して、リクエストに最適なモデルを自動選択します。2026年6月時点で、ルーティング設定は Console → 設定 → ルーティング から管理可能です。

| ルーティング方式 | 設定場所 | API リクエストパラメータ | | ------------------ | ------------------------------------- | ---------------------------------- | | 自動ルーティング | Console → 設定 → ルーティング | "model": "auto" | | 手動モデル選択 | リクエスト体 | 指定モデル ID | | ルーティング戦略制御 | コンソールのルーティング設定 | 独自の動作を組織化 |

自動ルーティングは、モデルフィールドを省略せず、明示的に model: "auto" と記入した場合にのみ有効です。

どの統合方式を選ぶべきですか？

アプリケーションの動作環境に応じて適切な統合方式を選択してください。

| 方式 | 適用シーン | 主な変更点 | | ---------------------------- | ---------------------------------------- | --------------------------------- | | Python SDK | Python バックエンドスクリプトやサービス | base_url と api_key の設定 | | Node.js SDK | JavaScript/TypeScript サービス | baseURL と apiKey の設定 | | curl | 最速の手動検証 | リクエストヘッダと JSON ペイロードを直接送信 | | 既存の OpenAI 互換アプリ | カスタム基本 URL をサポート済みのアプリ | 基本 URL と API キーの置換 |

多くの開発者は、まず curl で素早く動作確認し、その後 Python や Node.js で実運用に組み込みます。

Gate.AI API リクエスト失敗の一般的な原因は何ですか？

トラブル時は、以下の項目を順に確認してください。

| 症状 | 原因の説明 | 解決策 | | ------------------------ | -------------------------------------------------------- | --------------------------------------------------- | | 401 または API キー無効 | API キーが欠落、期限切れ、誤コピー、Bearer 認証未使用 | 新規作成・再コピーし、"Authorization: Bearer YOUR_API_KEY" を使用 | | モデルが見つからない | 不正または利用不可のモデル ID をリクエストに使用 | Gate.AI のモデルドキュメントを参照、または model: "auto" でテスト | | OpenAI 互換コードのエラー | 基本 URL が不完全、または /v1 のみ記入 | 正しい完全 URL を使用してください | | 自動ルーティング未動作 | 自動ルーティングがオフ、または設定と異なる動作 | Console → 設定 → ルーティングで自動ルーティングを確認 | | 応答が空または例外 | リクエストフォーマット誤、またはモデルがサポートしないリクエスト | 最初はシンプルなチャットリクエストからテストし、段階的にパラメータ追加 |

認証、基本 URL、モデル ID の順に原因を絞り込みます。これらの基本的な確認で、多くの導入問題は解決します。

今後設定可能な内容は何ですか？

最初のリクエスト成功後、開発者は以下の3つの方向で統合を拡張できます。

• Gate.AI コンソールでモデルルーティングの動作を設定
• モデルの可用性を確認し、運用テスト用に固定モデル ID を選択
• 価格比較を行い、高負荷シナリオに適したモデルを選択

よくある質問と回答

なぜ model: "auto" の優先使用を推奨しますか？

API キー、基本 URL、リクエストフォーマット、ルーティング設定の一括検証が可能です。問題なければ、次に特定モデル ID のテストに進みます。

既存の OpenAI SDK で Gate.AI を呼び出せますか？

可能です。Gate.AI は OpenAI 互換の API フォーマットをサポートしており、API キーと基本 URL を設定するだけで動作します。

指定モデルに切り替えた際にリクエスト失敗する理由は？

モデル ID が存在しない、スペルミスがある、またはアカウントがサポートしていない可能性があります。Gate.AI のモデルドキュメントで ID を確認してください。

指定モデル使用時に自動ルーティングをオフに必要ですか？

必須ではありません。手動でモデルを選択したい場合は、リクエスト体にモデル ID を記入します。動作がおかしい場合は、コンソールのルーティング設定を確認してください。