OpenAI API 接続チュートリアル：アカウント、Key、Base URL と初回呼び出し（2026）

OpenAI API の接続に必要なものは 4 つだけです。ログインできるアカウント、有効な API Key、課金が有効なプロジェクト、そして正しい Base URL と 1 回の成功した呼び出しです。簡単に聞こえますが、新しいチームが実際につまずくのはコードではなく、アカウント体系、支払い方法、URL の組み立てであることがほとんどです。

本記事は実際の操作順に沿って説明します。アカウントとプロジェクト、Key の作成、チャージ、SDK のインストール、Responses API での初回呼び出し、使用量の確認、401 と 429 の切り分け、最後に Base URL を OpenAI 互換ゲートウェイへ切り替える方法です。本文の例は主に Responses API を使います。Chat Completions しかサポートしない旧ツールでは、同じ考え方でエンドポイントを置き換えてください。

注記：OpenAI、ChatGPT、GPT は OpenAI の商標です。本記事は 2026 年 10 月時点で公開されているインターフェースの挙動を例にしています。モデル名、割当量、価格はモデル価格および公式ドキュメントを基準にしてください。

一、アカウント、組織、プロジェクトの違い

OpenAI プラットフォームには少なくとも 3 層の構造があり、混同すると最もエラーが起きやすくなります。

アカウント：ログイン資格情報で、誰がコンソールに入れるかを決めます。
組織：請求と使用量の帰属単位で、チームでの協業は通常この単位で管理します。
プロジェクト：Key、使用量、権限を分離する単位で、環境や業務ごとに分けることを推奨します。

よくある誤解は、ChatGPT のサブスクリプションを API の残高とみなすことです。両者は別会計です。サブスクリプションはチャット製品の利用権であり、API は実際の呼び出しに応じて別途課金されます。チームで導入する前に、誰がアカウントを管理し、誰が支払いを担当し、誰が管理者権限を持つかを決めておかないと、担当者が変わったときに Key の帰属が分からなくなります。

二、API Key を作成する順序

次の手順に沿って進め、途中を飛ばさないでください。

管理者アカウントで API コンソールにログインし、現在の組織が正しいことを確認します。
組織の下に新しいプロジェクトを作成するか既存のものを選び、「開発 / テスト / 本番」で分けます。
プロジェクトの API Keys ページで新しいキーを作成します。
用途が分かる名前を付けます。例えば「本番-カスタマーサポート Bot」です。
完全な Key をすぐにコピーし、パスワードマネージャーやデプロイ先のシークレット管理に保存します。
必要に応じてプロジェクトの権限、予算、上限を設定してから保存します。

完全な Key は通常、作成時に一度しか表示されません。ページに前後の数文字しか残らないのは正常で、後から再コピーできると考えないでください。紛失した場合は新しい Key を作成して古いものを無効化します。復元しようとしないでください。

三、チャージ、請求、割当量

API が前払いか後払いかは、アカウント種別と地域によって異なります。詳細はコンソールの表示に従ってください。開通前に次の 3 点を確認します。

支払い方法が自分のカードやチャネルに対応しているか。
請求サイクルと請求書をどう取得するか。
プロジェクトに予算アラートと上限を設定できるか。

支払い失敗は接続段階で頻発する問題です。カードが拒否された場合は、請求先住所、カード名義、認証方式を確認してからカード発行会社に問い合わせてください。短時間に何度も再送信すると、リスク管理によってロックされることがあります。ゲートウェイ経由で接続するチームは通常、人民元でのチャージが可能です。具体的な料率と着金ルールは料金ページを基準にしてください。価格は調整されるため、注文前にページの表示を確認してください。

四、SDK をインストールし、最初の curl リクエストを送る

まず公式 Python SDK をインストールします。

python3 -m pip install --upgrade openai
export OPENAI_API_KEY="sk-あなたのキー"
export OPENAI_BASE_URL="https://api.openai.com/v1"
export OPENAI_MODEL="料金ページまたは公式ドキュメントからコピーしたモデル名"

curl で Responses API を呼び出し、アドレス、Key、ネットワークが通ることを確認します。

curl -sS "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$OPENAI_MODEL"'",
    "input": "API ゲートウェイとは何かを一文で説明してください。"
  }'

モデル名は記憶で書かず、料金ページまたは公式ドキュメントから現在利用できる名称をコピーして OPENAI_MODEL 環境変数に保存します。200 が返り、レスポンス本文に出力があれば経路は通っています。401 が返る場合はまず Key を、404 の場合はまず Base URL とモデル名を確認してください。

五、Python での初回呼び出し

以下は Responses API で最小限のリクエストを送り、テキスト結果を出力する例です。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://api.openai.com/v1"),
)

resp = client.responses.create(
    model=os.environ["OPENAI_MODEL"],
    input="あなたの能力の境界を三文で説明してください。",
)

print(resp.output_text)

利用中のフレームワークが Chat Completions しかサポートしない場合は、呼び出しを client.chat.completions.create(...) に変え、メッセージを messages に入れます。2 つのインターフェースはリクエストパスが異なるため、混用すると 404 が起きやすくなります。

六、使用量と請求の見方

コンソールの Usage ページは通常、プロジェクト、モデル、時間の 3 軸で消費量を表示し、入力と出力を区別します。接続初期は毎日 1 回確認し、次の点を見てください。

どのプロジェクトが消費しているか。
入力と出力がそれぞれどれくらいか。
異常な失敗リトライがないか。
予算アラートが有効か。

呼び出しのレスポンスに含まれるリクエスト ID はログに残してください。請求の異議や障害が起きたとき、リクエスト ID はサービス側が問題を特定するための一次情報になります。チームはアプリ側でユーザー、機能モジュール、リクエスト ID の対応関係も記録すべきです。そうしないと請求では総量しか分からず、原因を特定できません。

七、401 と 429 の切り分け

401 は身元が認められないことを意味します。順番に確認してください。リクエストヘッダーに Bearer があるか。Key に余分な空白や改行が入っていないか。Key が削除されたり、所属プロジェクトが停止されていないか。ゲートウェイの Key を公式アドレスに送っていないか。Key を交換する前に、リクエストが実際どこへ送られているかを確認してください。そうしないと無駄に終わることがあります。

429 には 2 つの意味があります。レート制限と残高不足です。レスポンス本文のエラーコードとヘッダーを見てください。一律に速度を落とす必要はありません。insufficient_quota は通常、残高や割当量を示すため、チャージまたはプロジェクト上限の調整が必要です。レート系のエラーにこそ指数バックオフが適しています。リトライが意味を持つのは 429、5xx、ネットワークエラーのみです。400、401、403、404 をリトライしても割当量を消費するだけです。失敗したリクエストの扱いと料金の確認方法は料金ページを参照してください。

八、公式直結と互換ゲートウェイの選び方

観点	公式直結	OpenAI 互換ゲートウェイ
接続先	`https://api.openai.com/v1`	ゲートウェイが提供する Base URL。通常は `/v1` で終わる
アカウントと支払い	公式アカウント。公式が対応する支払い方法	サイト内アカウント。人民元チャージと請求書に対応
ネットワーク	ローカルネットワークと越境経路に依存	通常、国内からアクセスできる入口を提供
モデル範囲	OpenAI 自社モデル	複数ベンダーのモデルを併売する場合がある。料金ページを基準
課金	公式請求	サイト内残高と使用量記録
障害対応	公式サポート窓口	ゲートウェイ側が上流を調査。ユーザー側はリクエスト ID を保持
向いている場面	OpenAI のみを使い、規程に沿った支払い経路がある	国内チーム、複数モデル、請求の統一を望む

選ぶときは単価だけを見ないでください。支払いがスムーズか、障害時に誰が対応するか、モデルをいつでも切り替えられるかが長期的なコストに影響します。価格は変動するため、統一して料金ページを基準にしてください。

九、互換ゲートウェイへの切り替え：Base URL だけ変更

互換ゲートウェイは同じリクエスト形式を保つため、切り替えコストは想像より低いことが多いです。操作順は次のとおりです。

ゲートウェイに登録し、Key を作成します。入口は登録ページです。
OPENAI_BASE_URL をゲートウェイのアドレスに変更し、/v1 は残します。
Key をゲートウェイの Key に交換します。2 組の Key を混用しないでください。
モデル名はゲートウェイの料金ページからコピーします。公式名を流用して試すのは避けてください。
まず /v1/models と最小リクエストを呼び、その後で本番トラフィックを切り替えます。
公式または予備回線をフォールバックとして残します。

「OpenAI 互換」はリクエストとレスポンスの形式が互換であることを指し、すべての拡張機能が完全に一致するという意味ではありません。ファイル、バッチ処理、ツール呼び出しなどの高度なインターフェースが使えるかは、ゲートウェイのドキュメントで項目ごとに確認してください。すべて利用可能だと決めつけないでください。互換範囲の詳細はOpenAI 互換 API の説明を参考にしてください。

十、Key セキュリティと公開前チェック

Key が漏れると直接費用が発生します。最低限の要件は次のとおりです。

Key はサーバー側の環境変数またはシークレット管理サービスにのみ置き、フロントエンドコードに書かず、Git にもコミットしない。
環境ごとに Key を分け、テストと本番で共用しない。
Key ごとに担当者と用途を記録し、退職やプロジェクト変更時に速やかに無効化する。
ログに完全な Key を出力せず、末尾 4 文字だけを残す。
定期的にローテーションし、異常な呼び出しを検知したら即座に失効させる。

公開前に項目ごとに確認します。

[ ] アカウント、組織、プロジェクトの帰属が明確である。
[ ] 支払い方法が利用可能で、予算アラートを設定済みである。
[ ] Key が環境変数またはシークレット管理に保存されている。
[ ] Base URL の /v1 が 1 つだけである。
[ ] 最小リクエストが 200 を返し、内容が正常である。
[ ] 429 のバックオフと 5xx のリトライを設定済みである。
[ ] 使用量ログにリクエスト ID、モデル、所要時間が含まれている。
[ ] 予備回線と Key 無効化の手順を演習済みである。

十一、よくある質問

API Key と ChatGPT サブスクリプションは同じものですか？

いいえ。サブスクリプションと API は別々に課金され、API Key は API プラットフォームでのみ作成・管理します。チームの経費精算でも 2 つの支出を区別してください。

作成後に完全な Key が見えないのはなぜですか？

完全なキーは通常、作成時に一度だけ表示され、プラットフォームは識別用に一部の文字だけを保持します。紛失した場合は新しい Key を作成し、古い Key を無効化してください。

Base URL には何を書けばよいですか？

ドメインに /v1 を付けたところまでを書きます。/chat/completions や /responses は含めないでください。パスは SDK やリクエスト側が結合するため、余分に書くと 404 になります。

1 つの Key を複数プロジェクトで使えますか？

技術的には可能ですが、管理上は推奨しません。プロジェクトや環境ごとに Key を分けてこそ、権限を制御し、使用量を特定し、漏洩時の影響範囲を狭められます。

国内チームは必ずゲートウェイを使うべきですか？

必ずしもそうではありません。支払いチャネル、ネットワーク品質、コンプライアンス要件、複数モデルの要否によります。OpenAI のみを使い、安定した支払いとネットワーク条件があるチームは直結でも構いません。人民元決済と統一入口が必要なチームは、OpenAI 互換 API の説明を参考に移行方法を評価してください。

次のステップ

まず最小リクエストを通し、その後で業務に接続します。人民元でのチャージや複数モデルの統一入口が必要な場合は、ZSQH AI Gateway への登録から始めてください。モデルと価格はモデル価格を基準にしてください。