すべての記事
429を出さずにバルク処理を速くする：Gemini APIの適応的並行度制御
数万件をGemini APIに流すバルク処理で、固定並行度はほぼ必ず429と取りこぼしを生みます。429のフィードバックで並行度を自動調整するAIMD方式を、有界ワーカープールとデッドレター、再開可能なチェックポイントのコード付きで本番設計します。
Gemini 2.5 Flash で App Store のキーワード欄を多言語最適化した1ヶ月の所感
App Store Connect の100文字キーワード欄を、40本の壁紙アプリ×複数ロケールで Gemini 2.5 Flash に下書きさせた1ヶ月の運用ログです。CJK のバイト数問題、タイトル重複の排除、禁止語の落とし穴まで、現場でつまずいた点を淡々と記録します。
Gemini Embedding モデルを切り替える日：無停止リインデックスの設計
埋め込みモデルを新しくすると、過去に作った全ベクトルが使えなくなります。サービスを止めずに数十万件のベクトルを作り直す二重インデックス方式を、再開可能な再生成ジョブとクエリ側の抽象化層のコード付きで設計します。
Gemini 3 の thought signatures を保持してマルチターン function calling を壊さない本番設計
Gemini 3 の思考モデルで function calling を組むと、2 ターン目以降に推論が浅くなる現象に当たります。原因は thought signature の欠落です。署名を保持する本番実装と検証手順をまとめました。
Gemini 2.5 Pro で thinkingBudget を 0 にすると INVALID_ARGUMENT になる原因と対処
Gemini 2.5 Pro で thinkingBudget を 0 にすると 400 INVALID_ARGUMENT が返る原因を、モデルごとの思考予算レンジの違いから解説します。Pro でレイテンシを抑える正しい書き方と Flash への切り替え判断を Python・JavaScript のコード付きで紹介します。
Gemini 2.5 Flash で App Store Connect の日次売上をSlack要約に変えて2ヶ月運用した所感
App Store Connect の Sales/Trends API から落とした日次レポートを、Gemini 2.5 Flash で短いSlack要約に変える運用を2ヶ月続けた所感をまとめます。Pro との使い分け、AdMob 収益と並べて読むときの工夫、要約が滑った日の対処を運用ログから残します。
Gemini API の多段パイプラインに『残り時間予算』を伝播させる設計 — 4 秒 SLA を守りながら品質を段階的に落とす実装メモ
個人開発のヘルプ検索機能で多発した DEADLINE_EXCEEDED を、リクエスト単位の締め切り予算を埋め込み・検索・生成の各段に伝播させる設計で解消した記録です。残り時間に応じて maxOutputTokens を縮め、フォールバック予算を確保する実装を TypeScript でまとめています。
Embedding APIでアプリレビュー1万件を意味クラスタリングして改善優先度を割り出す設計
個人開発のアプリに貯まり続けるレビューを、Gemini Embeddingで意味クラスタに束ねて改善優先度を割り出す。実運用で固まった3層パイプラインとコスト設計の勘所を残します。
0.5B のローカル LLM を『前段ルーター』として使うときの設計 — Gemini Nano と Qwen 0.5B を並べて考える
Qwen2.5 0.5B のような超軽量ローカル LLM は『汎用チャット AI として弱い』と語られがちですが、設計思想を読むと意図が違います。Gemini Nano と並べて、モバイルアプリ開発者が前段ルーターとして使うときの判断軸を整理します。
Gemini API キーに HTTP リファラー制限をかけたら本番サイトから 403 エラーになる原因と対処
Google Cloud Console で API キーに HTTP リファラー制限を設定したら、ブラウザから叩く本番サイトでも 403 エラーが返るようになった、というつまずきの原因と対処を、リファラー文字列の書式・SDK 別の挙動・サーバー側プロキシへの逃し方、さらにブラウザ直叩きで起きる CORS エラーとの切り分けまで含めて整理します。
Gemini Advanced の Canvas で App Store 説明文を40本書き直した3週間の所感
Gemini Advanced の Canvas モードで、運用中の壁紙・癒し系アプリ40本分の App Store 説明文を3週間かけて書き直した実体験を整理します。並走させた書き直しの段取り、AI 任せにできた所と人間が必ず触る所、ASO の小さな効きを共有します。
Gemini API の応答キャッシュを 3 段で重ねた話 — メモリ・Redis・Context Cache の役割分担
Gemini API のレスポンスをメモリ・Redis・Context Cache の 3 段で重ねた設計と、6 週間の運用で見えたヒット率・コスト・無効化の落とし穴をまとめます。