◉GEMINI LABEN
●CLI 0.71 — Gemini CLI v0.71.0 のプレビュー版が公開されました。安定版は v0.70.0 のままです●TOOL RETR — Tool retrieval(Preview)で、道具の定義を必要なときだけモデルに読ませられるようになりました●2.5 ROUTE — 12/1 から gemini-2.5-pro は 3.8 Flash へ、2.5-flash は 3.5 Flash-Lite へ自動で回り、料金も移行先になります(残り9日)●OAUTH — 保存済みの MCP の OAuth トークンが、URL を差し替えた先にも確認なしで送られる、という報告が出ています●PICK — Gemini 4 のどのモデルを日常に使うかは、推論・長文・価格の3つで比べると迷いにくくなります●AG NEON — Antigravity の App v2.34.0 で、Gemini API キーからも Gemini 4 Neon を選べるようになりました●CLI 0.71 — Gemini CLI v0.71.0 のプレビュー版が公開されました。安定版は v0.70.0 のままです●TOOL RETR — Tool retrieval(Preview)で、道具の定義を必要なときだけモデルに読ませられるようになりました●2.5 ROUTE — 12/1 から gemini-2.5-pro は 3.8 Flash へ、2.5-flash は 3.5 Flash-Lite へ自動で回り、料金も移行先になります(残り9日)●OAUTH — 保存済みの MCP の OAuth トークンが、URL を差し替えた先にも確認なしで送られる、という報告が出ています●PICK — Gemini 4 のどのモデルを日常に使うかは、推論・長文・価格の3つで比べると迷いにくくなります●AG NEON — Antigravity の App v2.34.0 で、Gemini API キーからも Gemini 4 Neon を選べるようになりました
記事一覧/API / SDK
◈ API / SDK/2026-06-27上級

Project Spend Caps とアプリ側ソフト上限で、無人パイプラインの費用事故を二重に止める

Gemini API の Project Spend Caps(月額ドル上限)と、ハード上限の手前で止まるアプリ側ソフトサーキットブレーカーを二段構えにする設計。Python と sqlite による日次コスト台帳の実装コードつき。

Gemini API255コスト管理18Spend Caps自動化28運用設計15

✦ プレミアム記事

ある朝、コーヒーを淹れる前に Gemini API のダッシュボードを開いて、手が一瞬止まりました。前夜から無人で回している自動投稿パイプラインが、想定の数倍のリクエストを叩いていたのです。原因は単純で、ある外部 API が断続的に 5xx を返し、私が書いたリトライが素直に何度も叩き直していただけでした。料金としては大事には至りませんでしたが、「無人で回す」とは「気づかないうちに費用が積み上がる経路を常に開けておく」ことでもあると、静かに胸に刻みました。

2026年6月26日に一般提供へ進んだ Project Spend Caps は、まさにこの不安に効く更新です。プロジェクト単位で Gemini API の月間ドル上限を設定でき、変更か無効化をするまで効き続けます。ただ、ハード上限だけでは足りないというのが、個人開発で複数のアプリやブログを並行して無人運用してきた私自身の実感でした。そこで取り入れたのが、Project Spend Caps を土台に置きつつ、その手前で静かに止まるアプリ側のソフト上限を重ねる、二段構えの設計です。実装コードとあわせて残しておきます。

無人運用で費用が跳ねる瞬間はどこか

費用が跳ねるのは、たいてい人が見ていない時間帯です。そして原因は数えるほどしかありません。

第一に、リトライの暴走です。一時的な 429 や 5xx に対して指数バックオフを入れていないと、失敗のたびに即座に叩き直し、短時間で呼び出し回数が膨らみます。私のヒヤリも、まさにこれでした。

第二に、モデルの取り違えです。下調べやタグ付けのような軽い前処理にまで重いモデルを当ててしまうと、1リクエストあたりの単価がそのまま何倍にもなります。出力トークンの単価は入力よりも高いため、長い応答を無造作に返させる設計も地味に効いてきます。

第三に、ループの取りこぼしです。エージェント的に「足りなければもう一度」を繰り返す処理で停止条件が甘いと、無限に近い往復が生まれます。Managed Agents のような自律実行を無人で走らせる場合、ここが一番こわい落とし穴になります。

これらはどれも、平常時のテストでは表に出ません。本番運用に乗せて、人が寝ている数時間のあいだに初めて牙をむきます。だからこそ、コードの正しさとは別のレイヤーで、費用そのものに天井を用意しておく必要があります。

Project Spend Caps はどこを守り、どこを守らないか

Project Spend Caps の役割は明快です。プロジェクトに紐づく Gemini API の月間支出が設定したドル額に達したら、それ以上の課金対象リクエストを止めます。クレジットカードの利用枠のように、最後の砦として効きます。

一方で、ハード上限には性質上の限界もあります。上限に達した瞬間、進行中の処理は一律に弾かれます。途中まで組み立てた記事の生成も、半分まで進んだバッチも、区別なく止まります。アプリから見れば、ある時刻を境に呼び出しが急にエラーを返し始める挙動になります。

つまりハード上限は「破滅を防ぐ」ためのもので、「優雅に減速する」ためのものではありません。月末に近づいて上限が迫っているとき、重要なジョブだけ通して些末なジョブを後回しにする、といった判断はハード上限にはできません。そこを埋めるのが、次に作るソフト上限です。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦Project Spend Caps で各プロジェクトに月額ドル上限を割り当て、暴走時の被害を構造で止める考え方
✦Python と sqlite で書く日次コスト台帳と、ハード上限の手前で作動するソフトサーキットブレーカーの実装
✦gemini-flash-latest への自動ダウングレードと thinking budget 制御で土台コストを下げる手順
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Gemini Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◈ API / SDK2026-09-08
値上げの日をまたぐ費用の見積もりを、はじめから二段で書く
Gemini Flash の導入価格は2026年12月31日で終わり、2027年1月1日から標準価格に切り替わります。世代を据え置いても避けられないこの日を、はじめての費用見積もりでどう扱うか。動くコードとともに書き残します。
◈ API / SDK2026-11-14
OpenAI 互換レイヤーで JSON の形が揃わないとき、既存コードを残したまま response_json_schema へ寄せる3段階
OpenAI SDK の送り先だけを Gemini に向けたコードで、構造化出力が効いていないように見えるときの確かめ方と、関数の境界を変えずに Gemini SDK の response_json_schema へ移す手順を Python で整理します。
◈ API / SDK2026-10-30
「API key expired」と出ても、期限切れとは限りません。キーを作り直す前に、実際に送られているキーを確かめる
Gemini API が 400 の API_KEY_INVALID を返しても、応答だけでは期限切れか別の原因かを区別できません。環境変数の優先順位と空白・引用符を手元で確かめる診断スクリプトを、ダミーキーで動かした結果とともに残します。