事前準備
接続方法にかかわらず、次を確認してください。- コンソールで API Key を作成していること。
- その API Key のグループで対象モデルを利用できること。
- モデルマーケットから正確なモデル ID をコピーしていること。
- 対象モデルが対応する API 形式を確認し、HTTPS でリクエストすること。
よくある利用方法
URL とプロトコルの対応
この表は接続方法を選ぶためのものです。まずAPI とモデル機能の対応表でモデルとプロトコルを確認し、パラメーターとレスポンス構造は Chat Completions を参照してください。特定の Key とモデルでの実際の利用可否は、モデルマーケットの表示が基準です。
先に正しいプロトコルを選ぶ
Base URL が同じでも、すべてのモデルが同じリクエスト形式を受け付けるわけではありません。URL が異なって見える理由
汎用的な OpenAI 形式のリクエストでは、通常次を使用します。/v1 を含まないサイト URL を要求したり、/chat/completions、/responses、/messages を自動で追加したりします。必ず対象ツールのガイドに従ってください。画像モデルについては画像モデルの使い方を参照します。
クライアント設定と汎用 API を混用しない
CLI ツール、エディタ拡張機能、自作アプリケーションでは、使用するプロトコルや設定ファイルが異なります。モデル名が同じでも、あるツールの設定を別のツールに丸ごと適用しないでください。- Codex CLI:Codex CLI ガイドに従い、Responses 用の設定を使用します。
- Claude Code:Claude Code ガイドに従い、ネイティブ Anthropic Messages 設定を使用します。
- **自作テキストアプリ:**SDK が別のプロトコルを明示的に要求しない限り、Chat Completions から始めます。
- **画像生成:**画像エンドポイントを使い、画像生成用のパラメーターをテキストチャットのエンドポイントに渡さないでください。
- **判断できない場合:**設定を変更する前に、正確なクライアント名と実際のリクエストパスを確認します。
API リファレンス
対象モデルに適したプロトコルはAPI とモデル機能の対応表で確認できます。最小の Chat Completions リクエストは Chat Completions にあります。 このヘルプセンターでは、統合方法の選択と設定、検証可能な最小リクエストを説明します。任意パラメーターは、クライアントのプロトコルとモデルマーケットに現在表示されている機能に従って選択してください。設定成功を確認する
- クライアントが完全なレスポンスを返す。
- コンソールの利用ログに対応するリクエストが表示される。
- ログのモデル、グループ、課金額が想定どおりである。
