本文へスキップ
AI通信
OpenAI API入門の3ステップ：APIキー発行・Playground実験・SDKコール完了を示すインフォグラフィック
テクノロジー #OpenAI #API #ChatGPT #開発者 #Playground #Python #Node.js

OpenAI API入門 — APIキー取得からPlaygroundとSDKまで

OpenAI Platformへの登録からAPIキー発行、Playgroundでのプロンプト実験、Python/Node.js SDKによる最初のAPI呼び出し、モデル系統と料金の考え方まで初心者開発者向けに解説する。

| 約17分

この記事は「ChatGPT入門ガイド2026年版」の関連記事だ。

OpenAI APIを使いたいと思ったとき、最初に突き当たる壁がある。「ChatGPT Plusを契約しているのに、なぜAPIが使えないのか」という疑問だ。

答えは単純だ。ChatGPTのサブスクリプションとOpenAI APIの課金は、完全に独立したシステムである。どちらもOpenAIが提供しているが、入口も料金体系も管理画面もまったく別物だ。この事実を理解するだけで、OpenAI API入門のハードルは半分以下になる。

本記事では、開発者向けプラットフォーム「OpenAI Platform（platform.openai.com）」へのアクセス、APIキーの発行と安全な管理、コード不要で試せるPlayground、そしてPython/Node.jsによる最初のAPIコール、さらにモデル系統と料金の考え方を順に整理する。読み終えたとき、APIキーを手にして最初のコールを完了するための全手順を把握した状態になることが本記事のゴールだ。

OpenAI Platformとは — ChatGPT.comと何が違うのか

platform.openai.comとchatgpt.comは別サービス

OpenAIには、大きく分けて2つのウェブサービスがある。

観点ChatGPT（chatgpt.com）OpenAI Platform（platform.openai.com）
対象ユーザー一般ユーザー開発者・技術者
主な用途チャット形式のAI対話APIキー発行・Playground・課金管理
APIキー発行不可可能
モデル選択プランに応じて自動手動で選択可能
パラメータ調整不可temperature等を細かく設定可能

ChatGPT（chatgpt.com）は一般ユーザーが会話で使うインターフェースだ。一方、OpenAI Platform（platform.openai.com）は開発者向けの管理基盤であり、APIキー発行・利用量のモニタリング・課金管理・Playgroundによるプロンプト実験を提供する。

自分のアプリやスクリプトからOpenAIのモデルを呼び出したい場合は、ChatGPT側ではなくPlatform側に登録する必要がある。

ChatGPTサブスクとAPI課金は完全に独立している

ここは混乱が起きやすいため、明確に整理しておきたい。

ChatGPT Plus/Pro等のサブスクリプション（月額制）は、chatgpt.comでのUI利用に対して支払うものだ。それによってAPIが使えるようになるわけではない。

API課金はOpenAI Platformに別途支払い方法を登録し、利用量に応じてUSD建てで課金される従量制だ。ChatGPTのサブスクとは完全に別のシステムで管理される（公式ヘルプでも明示されている）。

要点は1つに尽きる。

APIを使うには、Platform側に支払い方法を別途登録する必要がある。ChatGPTのサブスクが済んでいても、APIは動かない。

ChatGPT UIで見えるモデル選択肢（Instant/Thinking/Pro）はChatGPT専用のUI上の整理であり、APIで指定するモデル名（gpt-4oやo3等のバージョン名）とは別物だ。この点も初学者が混同しやすいポイントなので、頭の片隅に置いておいてほしい。

ここまでで、「なぜChatGPTサブスクを持っているのにAPIが動かないのか」という疑問は解消されているはずだ。ここからは、実際にAPIキーを発行する手順に移る。

APIキーの発行と安全な管理

platform.openai.com/api-keys からの発行手順

APIキーは「APIへのアクセスを許可するパスコード」のようなものだ。このキーを持っていなければ、どんなコードを書いても認証が通らない。発行の手順はシンプルだ。

  1. platform.openai.com にアクセスし、アカウントを作成（またはログイン）する
  2. 左メニューまたはplatform.openai.com/api-keysを直接開く
  3. 「Create new secret key」を押し、用途が分かる名前をつける（例：my-first-project）
  4. 生成されたキーをコピーする

発行時に一度だけ全文が表示される。この画面を閉じると二度と同じキーを確認できないため、必ずその場でコピーしてパスワードマネージャーや.envファイルに保存する。コピーし忘れた場合はそのキーを削除し、新たに発行し直すことになる。

1回しか全文表示されない — 環境変数OPENAI_API_KEYで管理する

APIキーをソースコード内にそのまま書くのは、鍵を玄関のドアノブにガムテープで貼り付けるようなものだ。GitHubにうっかりプッシュした瞬間、第三者に悪用されて意図しない課金が発生するリスクがある。

環境変数での管理が標準的なアプローチだ。

# macOS / Linux
export OPENAI_API_KEY="sk-proj-..."

# Windows（コマンドプロンプト）
set OPENAI_API_KEY=sk-proj-...

プロジェクト内に.envファイルを使う場合は、必ず.gitignoreに.envを追加してリポジトリから除外する。

# .gitignore に追加
.env

OpenAIの公式SDKはいずれも、環境変数OPENAI_API_KEYを自動で読み込む設計になっている。コードに直接キーを埋め込む例は本記事では一切使わない。

キーの管理方針

  • 用途ごとにキーを分ける（開発用・本番用・チームメンバー別など）
  • 使わなくなったキーはすぐにPlatform上で削除する
  • Platform（platform.openai.com/settings）ではプロジェクト・組織単位での管理も可能

APIキーを手にしたら、次はコードを書く前にPlaygroundでプロンプトを試してみる段階だ。Anthropic ConsoleのWorkbenchに相当する実験環境だと考えるとわかりやすい。

Playgroundでコードなしにプロンプトを試す

Playgroundの主な機能

platform.openai.com/playgroundにアクセスすると、ブラウザ上でOpenAIのモデルをリアルタイムに試せる環境が開く。プログラムを書かずに、モデルの応答を確認できる点が大きなメリットだ。

Playgroundで操作できる主な項目を整理する。

  • モデル選択：利用可能なテキスト系モデルをドロップダウンで切り替えられる（2026年6月8日時点・公式で要確認）
  • システムプロンプト設定：モデルの役割や制約を事前定義できる（例：「あなたは日本語のカスタマーサポートです」）
  • temperatureの調整：応答のランダム性をスライダーで変更できる（0に近いほど決定論的、1に近いほど多様な応答）
  • max tokensの設定：一度に出力するトークン数（API用語では「出力の文字量の上限」）の上限を設定できる

ここで一度、問いを置きたい。

プロンプトをコードに組み込む前に、Playgroundで5回試行するだけで、ロジックのミスをどれだけ減らせるか想像してほしい。設定を固めてからコードに移行するという習慣は、デバッグ時間を大幅に短縮する。

コードへの書き出し（Get Code）

Playgroundには「View code」ボタンがあり、その場で試した設定をそのままコードとして書き出せる。出力されるコードはPythonとNode.jsの両方に対応しており、SDKへの移行がスムーズになる。

Playgroundでの操作も、発行したAPIキーに紐づいたトークン消費として課金される点は留意が必要だ。ただし開発初期の試行錯誤の量であれば、費用はほぼ無視できる水準にとどまる。

Playgroundでプロンプトの設計が固まったら、いよいよSDKでコードに落とし込む番だ。

SDKで最初のAPIコールを書く（Python / Node.js）

Python SDK

PythonのOpenAI SDKをインストールする。

pip install openai

環境変数にAPIキーを設定済みであれば、以下の最小コードで最初のAPIコールが完了する。

from openai import OpenAI

# 環境変数 OPENAI_API_KEY を自動で読み込む（コードに直書きしない）
client = OpenAI()

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "OpenAI Platformとは何か、2文で説明してください。"}
    ]
)

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

OpenAI()のコンストラクタは、環境変数OPENAI_API_KEYを自動で読み込むため、api_key=の引数を明示的に渡す必要はない。

モデル名の指定について：model="gpt-4o"の部分はあくまで例示だ。利用できるモデル名はplatform.openai.com/docs/modelsで確認してほしい。モデル名はOpenAIのリリース状況に応じて変わる（2026年6月8日時点・要公式確認）。

Node.js（TypeScript）SDK

Node.jsプロジェクトの場合、公式SDKをインストールする。

npm install openai

TypeScriptでの最小コード例を示す。

import OpenAI from "openai";

// 環境変数 OPENAI_API_KEY を自動で読み込む
const client = new OpenAI();

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    {
      role: "user",
      content: "OpenAI Platformとは何か、2文で説明してください。",
    },
  ],
});

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

Pythonと同様に、new OpenAI()は環境変数OPENAI_API_KEYを自動で参照する。

ここまでの手順を整理すると、Platformでアカウントを作り→APIキーを発行して環境変数に設定し→SDKをインストールして10行前後のコードを書く、という流れで最初のAPIコールが完了する状態になる。思ったよりシンプルだと感じたなら、それが正しい感覚だ。

SDKでAPIを呼び出せるようになったら、次に気になるのが「どのモデルを使えばよいのか」と「いくらかかるのか」という問いだろう。

使えるモデル系統と料金の考え方

テキスト系モデルの系統（2026年6月時点・要公式確認）

OpenAI Platformでは複数のテキスト系モデルが提供されている。2026年6月8日時点では大まかに以下の系統が存在するが、バージョン番号・モデル名・料金はOpenAIのリリース状況に応じて変動する。実装前に必ずplatform.openai.com/docs/modelsを確認すること。

系統特徴（2026-06-08時点・要確認）向くユースケース
フラッグシップ系高度な推論・複雑なタスク対応難度の高い分析、コード設計、多段の論理処理
ミニ系（高速・低コスト）低レイテンシ・高コストパフォーマンス大量処理、シンプルな応答生成
推論特化系（o1/o3系等）時間をかけた深い推論数学・科学・複雑なコーディング問題

ここで重要なのは、ChatGPT UIで見えるモデル選択（Instant/Thinking/Pro）はUIレベルの整理であり、API経由で指定するモデル名（gpt-4o、o3等）とは別物だという点だ。同じOpenAIのモデルでも、UI側とAPI側で呼称が異なる場合があるため混同しないよう注意してほしい。

画像生成モデル — gpt-image-2（DALL-E後継）

画像生成をAPI経由で行う場合、現時点ではgpt-image-2が主要な選択肢だ。DALL-E 2/DALL-E 3のAPIスナップショットは2026年5月12日にOpenAIによって削除済みであり、以前の記事や古いドキュメントにあるDALL-E系のAPIコードはそのままでは動作しない。

gpt-image-2の詳細仕様とAPIコード例はplatform.openai.com/docs/guides/image-generationを参照してほしい。サブバージョンの存在も含めて、仕様の変動が比較的多いため一次ソースで確認するのが確実だ。

料金はUSD建て従量課金・変動する

OpenAI APIの料金はトークン単位の従量課金だ。入力トークン数と出力トークン数をそれぞれカウントし、モデルごとに設定されたレートで課金される。1トークンは英語で約0.75語、日本語では漢字1文字が1〜2トークン程度になることが多い。

料金はUSD建てで変動する。「いくらかかるのか」を把握したい場合はopenai.com/api/pricingで最新のレートを確認すること。記事内に具体的な金額を記載しても、更新タイムラグで誤情報になるリスクがあるため、ここでは数字を書かない。

開発初期のプロトタイプ段階であれば、費用を気にするほどの使用量にはなりにくい。まず動かしてみることを優先し、利用規模が拡大してきたタイミングでコスト設計を見直すアプローチが現実的だ。

Platform上では「Usage」タブで日別・モデル別のトークン消費量をリアルタイムに確認でき、「Limits」タブで月次の支出上限を設定できる。開発中は上限を低めに設定しておくと、予期しない課金のリスクを抑えられる。

まとめ — OpenAI API入門の要点と次の一歩

本記事では、OpenAI Platform入門に必要な手順を整理した。

要点を一文で言えば、platform.openai.comでアカウントを作りAPIキーを環境変数に設定すれば、10行前後のSDKコードでOpenAIのモデルを呼び出せる状態になる。

冒頭で設定したゴール——「APIキーを手にして最初のコールを完了するための全手順を把握した状態」——に、ここまで読み進めたことで到達しているはずだ。

改めて手順を確認しておく。

  1. platform.openai.com でアカウントを作成する
  2. platform.openai.com/api-keys でAPIキーを発行し、環境変数OPENAI_API_KEYに設定する
  3. Playground でプロンプトを試して設計を固める
  4. pip install openaiまたはnpm install openaiでSDKをインストールしてコードを書く
  5. モデル選択と料金は公式ドキュメント・料金ページで常に最新情報を確認する

次の行動として、まずplatform.openai.comを開いてアカウントを作成するところから始めてほしい。Playgroundでプロンプトを1つ試すだけでも、APIの感触を掴むことができる。最初のコードは不完全でかまわない。動かした結果から得られる差分が、次の設計精度を上げる材料になる。

本記事のスコープ外だが、OpenAI PlatformにはApps（旧Connectors）やChatGPT agent（旧Operator）など、APIをベースにした自動化・エージェント機能も存在する。これらは基本のAPIコールに慣れてから検討するのが混乱が少ない。発展的な活用については今後の関連記事で整理していく。

ChatGPTの全体像を改めて確認したい場合は「ChatGPT入門ガイド2026年版」に戻るのがおすすめだ。コーディング支援のAPIとしてOpenAIを活用したい場合は「ChatGPT Codex入門」も参考にしてほしい。

OpenAI APIを始めよう

platform.openai.com でアカウントを作成し、APIキーを発行するところから始めてみよう。

OpenAI Platformを開く

AI通信 編集部

AIが社会・ビジネス・日常へ浸透する構造を、官公庁・調査機関・一次論文のデータで追っています。速報より文脈、感覚より数字——変化の「なぜ」を理解することで、次の動きが読める記事を目指しています。

この記事をシェア

X Facebook LINE

関連記事