API / SDK
Gemini API と SDK の使い方を扱うカテゴリです。クイックスタートから Function Calling、構造化出力、ストリーミング、コスト最適化、本番運用のトラブルシューティングまで、実装コードつきの記事を集めています。
Gemini API のストリーミングが本番で「途中で切れる」とき、私が試している原因切り分けの順序
Gemini API のストリーミング応答が本番で途中で切れる症状に対して、ネットワーク・SDK・サーバー側のどこから疑うべきかの順序を整理しました。まず確かめたい3つの事実、切り分けの記録テンプレート、切断を監視シグナルとして使う考え方まで共有します。
Gemini 2.0 Flash の廃止スケジュールに個人開発を振り回されないための運用設計 — 5 月時点のリスク分散ノート
Gemini 2.0 Flash の廃止に向けて個人開発の本番ジョブを設計し直した運用ノート。プロバイダ抽象・新旧モデルの差分バッチ・フォールバック率の計測・コスト試算、そして廃止日を過ぎた 8 月時点の答え合わせまでを実測値つきで残します。
Gemini API の Structured Output でバリデーションエラーが返るときの原因と対処
Gemini API の responseSchema を使った構造化出力で頻発するバリデーションエラー（INVALID_ARGUMENT、schema mismatch、空配列、不要フィールド）の原因と、実運用で安定させるための実装パターンを個人開発の現場視点でまとめます。
App Store と Google Play のレビュー差分を Gemini で出す運用を6週間続けた所感
App Store と Google Play のレビューを Gemini API で並列に分類し、プラットフォーム間の差分から優先改善項目を抽出する運用を6週間続けた記録です。累計5,000万DLの壁紙アプリで実際に見えた3つのプラットフォーム差と、月の運用コストを共有します。
Gemini API の冪等性キー設計 — 6サイト並行運用でリトライによる重複生成を防いだ実装パターン
個人で6サイトを並行運用してきた中で、Gemini API のリトライ嵐が原因の重複生成に悩まされました。SHA-256 ハッシュと Cloudflare Workers KV を組み合わせた冪等性キー設計の実装パターンと、5ヶ月分の運用知見をまとめました。
Gemini API の Recitation block が発火する条件と、応答が消えないためのプロンプト・ポストプロセス設計
Gemini API でリサーチや要約系のエージェントを長時間動かしていると、ある日突然 finishReason: 'RECITATION' が連発し始め、応答本文が空のままセッションが切れる症状に遭遇します。著作権保護のかかった長文の逐語引用と判定された時の安全機構ですが、回避するためのプロンプト設計とポストプロセスを、6サイトの自動投稿パイプラインで実装した内容ごと共有します。
Gemini API で MALFORMED_FUNCTION_CALL が返ってくるときの原因と対処
Gemini API の function calling で finishReason: MALFORMED_FUNCTION_CALL が返ってくる現象について、再現条件・3つの根本原因・実運用で効いた対処を整理しました。
Gemini 2.5 Flash と Firebase Remote Config で多言語オンボーディング文言を生成し、段階公開で検証する実装ノート
壁紙アプリ6本のオンボーディング文言を Gemini 2.5 Flash で多言語生成し、Firebase Remote Config の段階公開で D1 リテンションを検証した個人開発者の実装ノートです。Apps Script のコードと AdMob 連動の計測設計まで含めて記録しました。
複数アプリを抱える個人開発者のための Gemini API コントロールプレーン設計
壁紙・癒し・引き寄せ系を含む複数アプリで Gemini API を運用していると、いつの間にかキーが散らばり、コスト按分が分からなくなります。中央管理層を一枚挟む設計を、12ヶ月運用で見えた落とし穴とともに整理しました。
responseSchema の enum 指定なのに違う文字列が返る — Gemini API で起きる原因と回避策
Gemini API の responseSchema で enum を指定したのに許可値以外の文字列が返る現象を、最小再現コードから原因まで掘り下げます。プロンプトへの許可値明示、受け取り側のバリデーションとリトライ、SDK バージョン差の確認という3つの対処を示します。
Gemini API × Cloud Pub/Sub によるイベント駆動 AI ワークフロー設計 — 個人開発者の実装メモ
Gemini API を Cloud Pub/Sub のイベント駆動型ワークフローに組み込む実装メモ。アプリレビュー解析パイプラインを題材に、リトライ・デッドレター・冪等性・コスト管理までを個人開発の視点で整理しました。
Gemini API の出力品質を継続監視する評価基盤の設計
Golden Dataset と LLM-as-Judge を組み合わせ、Gemini API の出力品質が運用中に静かに劣化していくのを捉える評価基盤の設計を、個人開発の実運用構成とコード付きでまとめます。
Gemini API のストリーミングが本番だけまとめて返ってくる — Cloud Run・Vercel・Cloudflare のバッファリング対処
ローカル開発では一文字ずつ流れるのに本番デプロイ後だけ応答が一括で返ってくる — Cloud Run / Vercel / Cloudflare Workers / Nginx で発生するストリーミングバッファリング問題を、原因と対処パターン別に整理しました。
Gemini 2.5 Pro で AdMob 週次レポートからフロアプライス候補を導出する — 6 アプリ並行運用の実装メモ
AdMob のフロアプライス（最低入札価格）調整を勘ではなくデータで進めるための、Gemini 2.5 Pro を使った週次解析パイプライン。6 アプリ並行運用の現場で見えた数字と、Function Calling で候補値を構造化出力させる実装をまとめます。
Gemini API 構造化出力スキーマを本番アプリで安全に進化させる設計記録
本番アプリで Gemini API の JSON 出力スキーマを変えるとき、何を契約として守り、何を段階的に切り替えるか。旧版と新版を同時に返す Dual-Emit パターン、旧スキーマ利用箇所を見積もる compatibility checker、Sunset プロトコルの実装記録です。
Gemini Files API と Cloudflare R2 を組み合わせた画像処理パイプライン設計 — 壁紙アプリ運営の実装メモ
Gemini Files API と Cloudflare R2 を組み合わせ、壁紙アプリの画像処理パイプラインを再設計した30日の記録です。48時間制限・冪等性・コスト監視の落とし穴と対処を、実装コードと数値で整理しました。
Gemini API の seed を指定しても出力が毎回変わる原因と対処
generationConfig に seed を指定しても Gemini API の出力が毎回変わる原因を整理しました。seed だけでは決定論にならない理由、まず確認すべき3つの設定、壁紙アプリの分類パイプラインで実践している「ほぼ決定論」を確保する運用パターンを紹介します。
Gemini API にサーキットブレーカーと段階的縮退を組み込む — 個人アプリの安定運用に効く設計の所感
個人アプリで Gemini API を本番運用していると、月に数回は確実に外部要因で詰まります。サーキットブレーカーと段階的縮退をどう設計するか、実装の骨組みと運用で詰まりやすい所を所感としてまとめます。
壁紙アプリの色違いバリエーションを Nano Banana 2 で組み直した実装メモ — Imagen 4 停止後の移行と、解像度で変わる採算
壁紙アプリの色違いバリエーション生成を gemini-3.1-flash-image（Nano Banana 2）へ引き直した実装記録です。Imagen 4 停止後の移行先、Interactions API での呼び出し、解像度別の実価格で引いた二段構えの設計、停止済みモデル ID の検出までをまとめました。
Apps Script から Gemini API を呼ぶと長い生成で止まる原因と対処 — UrlFetchApp タイムアウトと 6 分実行上限の壁
Apps Script から Gemini API を呼んだときに UrlFetchApp のタイムアウトと 6 分の実行上限のどちらで止まっているかを見分け、分割実行・チェックポイント・トリガー再開で乗り切る実用パターンをまとめます。
Gemini Vision で壁紙アプリの自動カテゴリ分類を実装した話
個人開発の壁紙アプリで Gemini Vision API を使い、画像の自動カテゴリ分類を実装した実体験です。精度改善のプロセスと、公式ドキュメントには載っていない落とし穴、GPT-4o Vision とのコスト比較までまとめました。
Gemini API asyncio 非同期処理の本番パターン——並列リクエストで処理時間を1/5に短縮した実装記録
Gemini API の asyncio 非同期処理を本番環境に組み込んだ実装記録。Semaphore によるレート制限対策、指数バックオフ、部分失敗の扱い方まで、個人開発アプリのバックエンドで実際に遭遇したパターンを整理して紹介します。
git log から日英リリースノートを Gemini API で自動生成した — Beautiful HD Wallpapers v2.1.0 での実装記録
個人開発アプリのリリースノートを毎回手書きしていたコストに気づき、Gemini API で git log から日英自動生成するスクリプトを作った記録。Beautiful HD Wallpapers v2.1.0 のリリース作業で実証し、30言語対応への拡張方法も紹介します。
Gemini API で画像バッチ分析の INVALID_ARGUMENT エラーを診断する
Gemini API で複数画像を一括分析するとき INVALID_ARGUMENT エラーが出て詰まった経験はありませんか。MIMEタイプ・サイズ制限・リクエスト構造という3つの原因を診断し、File API と inline data を使い分けて根本解決する実践ガイドです。
Gemini API で iOS/Android アプリのメタデータを30言語自動生成した実装 — Beautiful HD Wallpapers の多言語化で気づいたこと
累計5,000万DLの壁紙アプリで実際に試した、Gemini APIを使ったApp Store/Google Playメタデータの多言語自動生成。翻訳精度を担保するプロンプト設計から文字数制限への対応まで、実装コードとともに公開します。
App Store / Google Play のレビュー返信を Gemini API で自動化したときにはまった「8秒ルール」
個人で運営するアプリ群でGemini APIによるレビュー返信自動化を試みた実装記録。多言語対応の設計と、App Storeで8秒以上待機しないとペナルティを受けるという落とし穴を共有します。
Next.js App Router の Server Actions から Gemini API を呼ぶときのエラー診断と解決策
Next.js App Router の Server Actions で Gemini API を呼ぶときに出る環境変数の undefined、ストリーミング不可、デプロイ後のみ出る Internal Server Error など実際のエラーと解決策をまとめました。
Gemini Vision で壁紙アプリのカテゴリ自動分類を試した — 精度と落とし穴の実記録
壁紙アプリの画像カテゴリ自動分類を Gemini Vision で実装した記録。精度67%から87%への改善手順と、confidence 閾値で人間レビューを全体の15%に絞り込む運用設計を紹介します。
Firebase Crashlytics のクラッシュログを Gemini API で自動分析した記録 — 個人開発アプリ v2.1.0 での実証
Firebase Crashlytics の生ログを Gemini API に渡して根本原因とコード修正案を自動生成するパイプラインを、個人開発の壁紙アプリ v2.1.0 の実開発で検証した記録です。RecyclerView クラッシュの Before/After 付き。
Gemini API を asyncio で並列化したら、壁紙アプリの多言語説明文生成が12倍速になった
12言語の App Store 説明文生成を Gemini API の asyncio 並列化で13分から65秒に短縮した実装記録です。Semaphore によるレート制限対策と、google-generativeai から google-genai への移行で変わった点まで含めてまとめました。
Gemini API Embedding で詰まった3か所 — 壁紙アプリのカテゴリ自動分類で踏んだエラーと対処
Gemini API の Embedding をカテゴリ自動分類に組み込んで踏んだ INVALID_ARGUMENT・429・精度不足の3点を、次元の固定・切り詰め後の正規化・チェックポイント付きバッチ・recall@5 の計測台という形で整理した記録です。
累計5,000万DLの壁紙アプリで、Gemini Function Calling をレコメンドエンジンに使ってみた
2014年から12年間運営してきた壁紙アプリに、Gemini Function Calling を組み込んでレコメンドロジックを刷新した実装メモ。スキーマ設計からコスト試算、Claude/GPT との使い分け判断まで。
Expo + Gemini APIでAIチャットアプリを個人開発して審査まで通した実装記録
Expo と Gemini API で AI チャットアプリを作り、両ストアの審査を通すまでの実装記録です。ストリーミングの実測レイテンシ、画像入力の落とし穴、コスト上限の設計、リリース前チェックリストまでまとめました。
Gemini TTS API を SwiftUI アプリに組み込む — AVAudioEngine との連携で詰まった2つの問題
Gemini TTS API が返す PCM データを SwiftUI + AVAudioEngine で再生する実装を解説。PCM フォーマット変換と AVAudioSession 設定の2つの落とし穴を、実際のコードとともに紹介します。
Gemini Code Execution で詰まった3パターン — import エラー・タイムアウト・出力が空になるときの対処法
Gemini API の Code Execution で詰まりやすい3パターンを実例で解決します。機能が有効になっていない最多の原因、サンドボックスで使えないライブラリの import エラー、重い処理のタイムアウトについて、エラー情報を取得する実装とあわせて紹介します。
Gemini API を実アプリのバックエンドに採用して3ヶ月 — 個人開発者の正直な評価
癒し系・壁紙系アプリのバックエンドに Gemini API を採用して3ヶ月運用した評価記録です。コスト・レイテンシ・精度の実測値、無料枠の RPM 制限にぶつかったときの実装、Claude や GPT-4o との使い分け基準まで、想定外だった点も率直に書いています。
Gemini 2.5 Pro の thinking_budget を制御する — コストを3分の1にしながら推論品質を守る実装パターン
thinking_budgetを未設定のまま使うとGemini 2.5 Proのコストが予想外に膨らみます。タスク別最適値・動的制御・モデルルーティング・本番監視・バッチ事前見積りまで、個人開発での実践知見をコード付きで解説します。
AdMob収益の急落を朝8時に知る仕組みをGemini APIで作った
AdMob収益の異常をGemini APIのFunction Callingで自動検知する仕組みの実装方法を、個人開発10年以上の実体験をもとに解説します。前日比の閾値設定から原因分析まで、実際に動くPythonコードで紹介します。
AdMob + Gemini APIで個人開発iOS壁紙アプリの収益を最大化する設計パターン
iOS 壁紙アプリに AI 機能を足すとき、AdMob 収益と Gemini API コストのバランスをどう設計するか。個人開発10年の経験から、オンデバイスの Gemini Nano とクラウド API の分担、Freemium ゲートによる使用量制御、審査対策までまとめました。
Gemini 3.2 Flash のビジョン機能でアプリUIのリリース前チェックを自動化した実践記録
Gemini 3.2 Flash のマルチモーダル入力を使い、iOS/Android アプリのスクリーンショットを自動でビジュアルQAするスクリプトを実装した実践記録。個人開発者がリリース前に見落としがちなUIの崩れ・文字切れ・ダークモード差異を Python 30行で検出する方法を紹介します。