AI APIを個人で試すときの使いすぎ防止：上限設定と利用状況の見方

先に知っておく「通知」と「上限」の違い

設定項目は似ていますが、役割が違います。

• 支出アラート（通知）：設定額に達するとメールなどで知らせるだけで、API呼び出しは止まりません。
• ハードリミット（強制上限）：月の支出が設定額に達すると、対象のリクエストが429エラーで失敗します。組織単位と、プロジェクト単位のどちらにも設定できます。
• プリペイドの残高：残高がなくなると、課金エラーでリクエストが失敗します。

出典：Spend limits（OpenAI）

通知だけ設定して安心すると、夜間に暴走したときは気づけません。個人の試用なら、通知とハードリミットを両方入れるのが基本です。アラートはハードリミットを追加しても残るので、「手前で知らせ、その先で止める」構成にできます。

設定の手順（所要の目安は10分ほど）

手順1：試用専用のプロジェクトを作る

プロジェクト選択から「Create project」で作成します。プロジェクトごとにAPIキー、月額の支出上限、使えるモデルを分けられます。既定のプロジェクトを使い回さず、「お試し用」を別に作ると、後から利用状況を切り分けやすくなります。

出典：Managing projects in the API platform（OpenAI）

手順2：プロジェクトの月額上限とハードリミットを設定する

公式の手順は次のとおりです。

1. Project settings を開き、Limits を選ぶ
2. Spend の「Edit spend limit」で月額の上限を入力する
3. 「Enforce a hard limit」をオンにする

上限を作ると、上限の100%に達したときのアラートも既定で作られます。必要に応じて「Add Alert」で別のしきい値を足せます。通知を受け取るのはプロジェクトと組織のオーナーで、宛先のメールは追加できます。

手順3：手前のしきい値で通知を足す

100%の通知だけでは、気づいたときにはもう止まっています。たとえば月上限を1,000円にするなら、50%と80%にも通知を足す、という使い方です（金額は説明用の例です。自分の許容額に置き換えてください）。

手順4：使えるモデルを絞る

プロジェクトの「Model usage」設定で、使うモデルを限定できます。高価なモデルを誤って指定する事故を避けたいときに有効です。権限が必要な設定のため、自分がオーナーであることを確認してください。

手順5：プリペイドの扱いを決める

プリペイド課金のヘルプによると、最低購入額は5ドルで、購入したクレジットの有効期限は1年、原則返金不可です。残高が0になるとAPIは課金エラーを返し、処理の遅れによって一時的にマイナス残高になることもあります。

自動チャージ（残高がしきい値を下回ると自動で追加）は、初期設定ではオンになっているため、購入確定前に確認してください。自動チャージ分には月間の購入上限を付けられますが、手動購入は対象外で、既存残高の利用額も制限しません。試用の段階では、自動チャージをオフにして、少額を手動で入れる運用のほうが、想定外の請求の入り口を1つ減らせます。これは編集上の提案で、公式の推奨ではありません。

出典：Setting up and managing prepaid API billing（OpenAI）

キー管理の設定

上限を付けても、キーが流出すれば上限までは使われます。公式のキー安全ガイドの要点は次のとおりです。

• キーは共有せず、利用者ごとに別のキーを使う
• キーはコードに直接書かず、OPENAI_API_KEY などの環境変数に入れる
• ブラウザやモバイルアプリにキーを埋め込まない（バックエンド経由にする）
• GitHubなどのリポジトリにコミットしない
• 有効期限付きでキーを作り、定期的に入れ替える
• 漏れた疑いがあれば、利用状況を確認し、API Keys ページですぐにローテーション（入れ替え）する

出典：Best practices for API key safety（OpenAI）

個人の試用では、「有効期限を短めにしてキーを作る」「使わなくなったキーはその日のうちに削除する」の2つが、手間が少なく効果的な習慣です。

利用状況の見方：429が出たら何を見るか

利用状況ダッシュボードでは、トークンの消費を現在と過去の請求サイクルで確認できます。プロジェクト別に内訳を見る場合は、組織内の役割やダッシュボードの表示設定によって見られる範囲が変わります。プロジェクトのオーナーというだけでは見られないことがあるため、閲覧できないときは表示設定を確認してください。

出典：Production best practices（OpenAI）

429エラーが返ったときは、エラーコードで原因を切り分けられます。

• organization_spend_limit_exceeded、意味：組織の支出上限に到達、次にやること：使用量を確認し、上限を上げるか翌月まで待つ
• project_spend_limit_exceeded、意味：プロジェクトの支出上限に到達、次にやること：同上（そのプロジェクトのLimitsを見る）
• credit_balance_exhausted、意味：プリペイド残高が0、次にやること：使い道を確認してから、必要なら残高を追加する

上限を上げる前に、「なぜ想定より使ったのか」をダッシュボードで確認してください。ループ、再試行の暴走、大きな入力の繰り返しなど、原因を直さずに上限だけ上げると同じことが起きます。

初期設定チェックリスト

キーを発行する前に、上から順に確認してください。

支払い上限

• [ ] 試用専用のプロジェクトを作った
• [ ] そのプロジェクトに月額の上限を、払える額より低めに設定した
• [ ] 「Enforce a hard limit」をオンにした
• [ ] 組織側の上限も確認した（組織の上限は全プロジェクトに適用されます）
• [ ] 自動チャージをオフにした、または自動チャージ分の月間購入上限を付けた

通知

• [ ] 100%以外に、50%や80%などの手前のアラートを足した
• [ ] 通知メールが普段見るアドレスに届く設定になっている

キー管理

• [ ] 試用プロジェクト内でキーを1つだけ作った
• [ ] 有効期限を付けた
• [ ] 環境変数に入れ、コードやリポジトリには書いていない
• [ ] 使うモデルを絞った（任意）

運用

• [ ] 試す日の終わりに、ダッシュボードで当日の消費を見る習慣を決めた
• [ ] 429が出たら、上の表でエラーコードを確認してから対処する

補足：上限が効かないケースと注意点

• ハードリミットは反映に遅れがあり、設定額をわずかに超えることがあります。
• ハードリミットに達すると、そのプロジェクトのすべての呼び出しが止まります。試用では望ましい動作ですが、本番サービスでは止まること自体が障害になります。
• 上限はプロジェクトごとの設定です。別のプロジェクトを作ってキーを発行すれば、そちらはその設定が別に必要になります。新しいプロジェクトを作るたびに、このチェックリストを使ってください。
• 他社のAPI（AnthropicやGoogleなど）にも同様の仕組みはありますが、画面名や挙動は異なります。この記事では確認していないため、それぞれの公式ヘルプで確認してください。