Gemini API を Edge に載せると subrequest 上限で静かに落ちる — 残量を計装して守る運用メモ
Gemini API を Cloudflare Workers で運用していると、平常時は問題ないのに負荷やツール連鎖が深まった瞬間だけ subrequest 上限で落ちます。残量をリクエスト単位で計測し、予算として守るための計装パターンと実装を、個人開発で運用しているサイト群の知見からまとめます。
Gemini API のアプリで、無料ユーザーのコストが粗利を食う前に — ティア設計とコスト上限の実装メモ
Gemini API を組み込んだアプリの粗利を守るには、回数制限ではなく『1ユーザーあたりの月次コスト天井』で設計します。ティア別モデルルーティング、KVでの実コスト計測、トークン膨張の潰し方を実装例で示します。
Bun と Hono で Gemini API の軽量バックエンドを組む — 個人開発の小さなツールを自分の手に取り戻す実装メモ
Node と Express で書いた Gemini バックエンドが、依存関係とビルド時間で重くなっていませんか。Bun と Hono に載せ替えて、ストリーミング・レート制限・コスト上限・セルフホストまでを一つの軽い実行環境にまとめた実装と判断軸を、現場で踏んだ落とし穴とあわせて整理します。
Gemini API の SLO と Error Budget を個人開発で運用する設計 — 4 サイトの可用性を Burn Rate 監視で守る
Gemini API を 4 サイトの本番運用に組み込んできた立場から、個人開発でも実装できる SLO と Error Budget の運用設計をまとめました。Cloudflare Workers と KV を使った Burn Rate 計算、Multi-Window アラート、エラー予算消費時の機能凍結ルールを動くコード付きで共有します。
Gemini API の冪等性キー設計 — 6サイト並行運用でリトライによる重複生成を防いだ実装パターン
個人で6サイトを並行運用してきた中で、Gemini API のリトライ嵐が原因の重複生成に悩まされました。SHA-256 ハッシュと Cloudflare Workers KV を組み合わせた冪等性キー設計の実装パターンと、5ヶ月分の運用知見をまとめました。
Gemini API で User location is not supported が出たときに、本番環境で試した解決の順番
Cloudflare Workers や Vercel から Gemini API を呼んだときに突然出る『User location is not supported』エラー。個人開発のサーバー移行中に遭遇した実例をもとに、原因切り分けから本番復旧までの順番をまとめました。
Mastra と Gemini API で TypeScript エージェントを 30 分で本番投入する
TypeScript で AI エージェントを書くなら、Vercel AI SDK の薄さを保ちつつワークフローやメモリも扱える Mastra が現実解です。Gemini API と組み合わせて、ローカル開発から Cloudflare Workers デプロイまでを 30 分で一気通貫させる手順を解説します。