このガイドの内容
このガイドでは、OpenAI プラットフォームアカウントの作成またはサインイン、支払い設定、シークレットキーの作成、最初のリクエストの送信、使用量の確認、よくあるキーのエラーへの対処までを順に説明します。自分のスクリプトやアプリから OpenAI API を呼び出したい方向けです。ChatGPT のサブスクリプションは別の製品で、このガイドの対象外です。
前提条件
- アカウント: 自分で管理でき、復旧できる OpenAI のサインイン方法。
- 支払い: お住まいの地域で OpenAI が提供している支払い方法またはプリペイドオプション。利用できる方法は地域によって異なり、完全な一覧は確認できませんでした(UNKNOWN)。
- 基本的なコードの知識: ターミナルを開き、環境変数を設定し、短いスクリプトを実行できること。例では
curlと Node.js の JavaScript を使います。
ステップ 1: OpenAI プラットフォームアカウントを作成、またはサインインする
API キーのページを開きます。表示された指示に従ってサインインするか、アカウントを作成してください。自分が所有するアカウントを使用してください。
所属する組織にすでに API アカウントがある場合は、キーを共有するのではなく、組織の所有者に招待を依頼してください。OpenAI のメンバー管理ガイドに手順があります。
ステップ 2: 支払いを設定し、従量課金を理解する
OpenAI のエラーリファレンスからリンクされている請求設定ページを開きます。ページの指示に従って支払い方法またはクレジットを追加してください。
API の利用は従量課金です。OpenAI API の料金ページと開発者向け料金リファレンスに料金が掲載されています。リファレンスによると、特に表示がない限り価格は 100 万トークンあたりで表示され、一部の組み込みツールは別途掲載されています。使用予定のモデルの料金を開始前に確認してください。料金は変更されることがあり、モデルによっても異なるため、このガイドでは具体的な金額は記載しません。
プリペイド残高がなくなると、リクエストが credit_balance_exhausted エラーで失敗することがあります。後述のトラブルシューティングのセクションを参照してください。
ステップ 3: シークレットキーを作成し、一度だけコピーする
- API キーのページを開きます。
- 新しいシークレットキーを作成し、それを使うアプリまたはスクリプトに合わせた名前を付けます。
- キーをすぐにコピーし、パスワードマネージャーに保存します。OpenAI の API キーのヘルプ記事には、シークレットキーの全文は作成時にだけ表示される、と書かれています。紛失した場合は新しいキーを作成し、アプリケーションを更新してください。削除したキーは使用できません。
- キーをチャット、スクリーンショット、ソースコードに貼り付けないでください。
API キーのページの文言は読み取れなかったため、ボタン名はこの手順と異なる場合があります。
ステップ 4: 最初の API 呼び出しを行う
コードにキーを含めないよう、環境変数に保存します。macOS または Linux では、ターミナルで次のコマンドを実行し、プレースホルダーを自分のキーに置き換えてください。
export OPENAI_API_KEY="your_api_key_here"
Windows の PowerShell では、次のコマンドを使い、その後に新しいターミナルウィンドウを開いてください。
setx OPENAI_API_KEY "your_api_key_here"
curl でテストします。MODEL_ID は、お使いのアカウントで利用できるモデルに置き換えてください。
curl "https://api.openai.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "MODEL_ID",
"input": "Say hello in one short sentence."
}'
JavaScript の場合は、npm install openai で公式 SDK をインストールし、次の内容を hello.mjs として保存します。
import OpenAI from "openai";
// The SDK reads OPENAI_API_KEY from the environment.
const client = new OpenAI();
const response = await client.responses.create({
model: "MODEL_ID",
input: "Say hello in one short sentence.",
});
console.log(response.output_text);
node hello.mjs で実行します。開発者向けクイックスタートも同じパターンを使っています。エラーが出た場合はトラブルシューティングのセクションへ進んでください。
ステップ 5: 使用量を確認する
呼び出しが成功したら、プラットフォームアカウントの使用量ダッシュボードを開き、リクエストが表示されていることを確認します。OpenAI の使用量エクスポート記事では、API Usage Dashboard について説明されています。そこでは月次の使用量を確認でき、暦月全体または月初からの使用量や費用データを CSV でエクスポートできます。リクエストがまだ表示されない場合は、後でもう一度確認してください。反映までにかかる時間は確認できませんでした(UNKNOWN)。
API は無料で使えますか?
OpenAI の料金ページは従量課金の料金を示しています。新規アカウントに無料クレジットがあるか、どのモデルにも無料枠があるかは、公式ページでは確認できませんでした(UNKNOWN)。料金リファレンスには、無料と表示されている項目や無料枠を含む項目があります。たとえば一部のファイルストレージは 1 GB まで無料で、無料のモデレーションモデルも掲載されています。通話が無料だと想定する前に、使用するモデルとツールの現在の料金ページを確認してください。
キーを安全に保つには?
OpenAI の API キーの安全性に関するベストプラクティスに従ってください。実践的には次のとおりです。
- キーを git にコミットしないでください。 キーは環境変数またはローカルのシークレットストアに保存し、
.envファイルは.gitignoreに追加します。プッシュの前に、ステージされた変更を毎回確認してください。 - 漏えいしたら再発行してください。 キーがリポジトリ、ログ、スクリーンショット、チャットに現れたら、API キーのページで削除し、新しいキーを作成して、アプリケーションを更新してください。削除されたキーは動作しなくなります。
- プロジェクトごとにキーを一つ使ってください。 アプリ、スクリプト、チームメンバーごとに別々のキーを用意します。OpenAI は、API キーの共有は利用規約に反すると説明しているため、チームメイトには各自のアカウントへの招待を使ってください。
- 有効期限を設定してください。 プロジェクトキーには有効期限を設定できます。期限が切れる前に後継のキーを作成し、新しいキーが動作することを確認してから古いキーを無効化してください。
- サポートへの依頼にキーを含めないでください。 どのサポートチャネルにもキーを送る必要はありません。
キーが動作しないのはなぜですか?
ステータスコードとエラーメッセージを確認し、OpenAI のエラーリファレンスと照合してください。
| ステータスとメッセージ | 考えられる原因 | 対処法 |
|---|---|---|
401 Incorrect API key provided | キーが間違っている、削除されている、または別のアカウントのものである | API キーのページでキーを確認します。コード全体で同じキーを使っていることを確認してください。Incorrect API key providedを参照してください。 |
401 You must be a member of an organization | アカウントが、キーを所有する組織に含まれていない | 組織の管理者に招待を依頼してください。 |
401 IP not authorized | リクエスト元の IP アドレスが許可リストに含まれていない | 許可された IP からリクエストを送るか、許可リストを更新してください。 |
429 Rate limit reached for requests | 短時間にリクエストやトークンを送りすぎている | 送信間隔を空けてください。Retry-After ヘッダーがあればそれに従ってください。レート制限ガイドと 429 のトラブルシューティング記事を参照してください。 |
429 credit_balance_exhausted | プリペイドクレジットを使い切った | 請求設定でクレジットを追加してください。再試行するだけでは解決しません。 |
429 でエラータイプが insufficient_quota | 支払い関連の上限に達した | 請求と利用上限を確認し、429 のトラブルシューティング記事に従ってください。 |
403 Country, region, or territory not supported | サポートされていない国または地域から API にアクセスしている | エラーリファレンスからリンクされている対応国・地域の一覧を確認してください。 |
ここに掲載されていないメッセージは、エラーリファレンスで正確な文言を検索してください。すべての 403 メッセージの意味は確認できませんでした(UNKNOWN)。
Cue では自分の OpenAI API キーが必要ですか?
UNKNOWN です。Cue の公開ページ(heycue.io、料金、FAQ)を確認しました。モデルは掲載されていますが、私が読んだ範囲では、Cue 自体の機能に自分の OpenAI API キーが必要かどうかの説明はありませんでした。どちらの方法に頼る前にも、Cue の設定とプランの説明を確認してください。API キーを Cue のサポートに送らないでください。
未確認または入手できなかった項目
platform.openai.com/docs/quickstartはオリジンをまたぐリダイレクトが発生したため、たどりませんでした。代わりにdevelopers.openai.com/api/docs/quickstartの Markdown 版を使用しました。platform.openai.com/api-keysは読み取り可能なページ本文を返しませんでした。キーの手順は OpenAI のヘルプ記事に基づいており、ボタン名は未確認です。openai.com/api/pricing/は取得時に途中で切れていました。料金は開発者向け料金リファレンスに基づいています。本文では具体的な金額は記載していません。- 新規アカウントの無料クレジットまたは無料枠: UNKNOWN。
- すべての 403 メッセージの意味: 国または地域の場合以外は UNKNOWN。
- Cue で自分の OpenAI API キーが必要かどうか: UNKNOWN。
Cue は Sophon LLC が開発する独立したデスクトップ AI アシスタントです。 Cue を使えば、許可された文書、メモ、タスクを扱えます。Claude と GPT のモデルから選べます。アカウントに含まれる内容と利用できるモデルは、Cue のプランの説明で確認してください。OpenAI アカウントの API キー、請求、使用量は引き続き OpenAI が管理します。