GEMINI LABEN
NANOLITE — Nano Banana 2 Liteが登場しました。Googleで最も速く、最もコスト効率の高いGemini Imageモデルで、軽量な画像生成を安く回したい用途に向いていますOMNIFLASH — Gemini Omni Flashがpublic previewになりました。ネイティブにマルチモーダルなモデルで、企業や開発者が独自の動的な動画ワークフローを構築できますAGENTS — Managed Agentsが拡張されました。background: trueでサーバー側の非同期実行とポーリング、リモートMCPサーバー連携、対話をまたぐ認証情報のリフレッシュに対応しますMEMORY — Memory BankのIngestEvents APIが一般提供になりました。イベントの取り込みとメモリ生成を分離し、コンテンツを継続的にストリームできますTHROUGHPUT — Provisioned Throughputで、同一モデル・同一リージョンに対して最大7件の保留オーダーを提出できるようになりましたDEPRECATE — 画像生成モデルは8月17日に、Gemini Enterprise Agent PlatformのGrok 4.1系は8月20日に停止される予定ですNANOLITE — Nano Banana 2 Liteが登場しました。Googleで最も速く、最もコスト効率の高いGemini Imageモデルで、軽量な画像生成を安く回したい用途に向いていますOMNIFLASH — Gemini Omni Flashがpublic previewになりました。ネイティブにマルチモーダルなモデルで、企業や開発者が独自の動的な動画ワークフローを構築できますAGENTS — Managed Agentsが拡張されました。background: trueでサーバー側の非同期実行とポーリング、リモートMCPサーバー連携、対話をまたぐ認証情報のリフレッシュに対応しますMEMORY — Memory BankのIngestEvents APIが一般提供になりました。イベントの取り込みとメモリ生成を分離し、コンテンツを継続的にストリームできますTHROUGHPUT — Provisioned Throughputで、同一モデル・同一リージョンに対して最大7件の保留オーダーを提出できるようになりましたDEPRECATE — 画像生成モデルは8月17日に、Gemini Enterprise Agent PlatformのGrok 4.1系は8月20日に停止される予定です
記事一覧/API / SDK
API / SDK/2026-05-22上級

Gemini API の Recitation block が発火する条件と、応答が消えないためのプロンプト・ポストプロセス設計

Gemini API でリサーチや要約系のエージェントを長時間動かしていると、ある日突然 finishReason: 'RECITATION' が連発し始め、応答本文が空のままセッションが切れる症状に遭遇します。著作権保護のかかった長文の逐語引用と判定された時の安全機構ですが、回避するためのプロンプト設計とポストプロセスを、6サイトの自動投稿パイプラインで実装した内容ごと共有します。

gemini-api279recitation-blocksafety-settings2prompt-designproduction105

プレミアム記事

Gemini API を使ったコンテンツ生成エージェントをそこそこの規模で運用していると、ある日いきなり finishReason: "RECITATION" がログを埋め始めます。一見成功レスポンスのように見えるのに、candidates[0].content.parts は空。リトライしても同じ結果が返り、ユーザー側からは「画面に何も出ない」「途中で切れた」というクレームになります。2014年からアプリ事業をやってきた身として、Dolice ブランドで個人開発・運営している6サイト(Claude Lab・Gemini Lab・Antigravity Lab・Rork Lab・Lacrima・Mystery)のコンテンツ自動投稿パイプラインで、ある月に Recitation block が原因で月 20 回近く記事生成が止まり、夜間バッチを朝確認するたびに記事数が足りないという状況に陥っていました。

Recitation block は、Gemini が「いま生成しようとしている応答が、著作権保護されたコンテンツの長文逐語引用に該当しそうだ」と判定したときに発動する安全機構です。safetySettingsOFF にできる類のものではなく、内部のリサイテーション検出器が独立して動いているので、プロンプトとポストプロセスの両方の設計で発火率を下げる 必要があります。

ここでは、6サイトのパイプラインで実装した発火検知・回避プロンプト・ポストプロセス・最終リトライまでの一連のコードと、半年運用してわかった発火条件の温度感を共有します。

発火する5つの典型条件

ログを半年分集計した結果、Recitation block が発火するのはほぼ次の5パターンです。

  1. 既存記事・ニュース・論文の本文を長文引用する依頼(発生率 約 45%): 「次の記事の本文を踏まえて」「以下の論文の3章を要約して」のような依頼で、与えた原文の一部をそのまま再出力しようとすると発火しやすい
  2. 歌詞・詩・有名な文学テキストの再現(約 20%): 著作権保護期間中の歌詞・詩・小説の一節を、たとえ少量でも生成しようとすると発火する
  3. 公開コードベースの長文コピー(約 15%): 既存 OSS のコードを大きな塊で再出力しようとすると発火する(特定のフレームワークの公式チュートリアルの完全コピーなど)
  4. ニュース速報の見出しと第一段落の連続生成(約 12%): ニュース要約エージェントで、見出し・リード・本文の冒頭を続けて再現しようとすると発火する
  5. 長い JSON データの逐語再生(約 8%): 与えられたデータセットの全フィールドをそのまま JSON で出力しようとする処理で発火することがある

リトライで直る確率は、1番目で 5%、2番目で 0%、3番目で 30%、4番目で 10%、5番目で 60% でした。1〜4 はプロンプト設計の問題なので、リトライではなく 書き方を変えないと根治しません

API レスポンスからの検出ロジック

最初にやるべきは確実な検出です。Gemini API は Recitation block で停止すると、candidates[0].finishReason"RECITATION" にし、content.parts を空にして返します。ステータスコードは 200 OK なので、ナイーブな実装だと「空の成功レスポンス」として通り抜けてしまいます。

import { GoogleGenerativeAI } from "@google/generative-ai";
 
interface DetectionResult {
  isRecitation: boolean;
  partial: string;          // RECITATION 直前まで生成された部分
  citationMetadata?: unknown;
}
 
function detectRecitation(response: any): DetectionResult {
  const candidate = response?.candidates?.[0];
  if (!candidate) return { isRecitation: false, partial: "" };
 
  const finishReason = candidate.finishReason ?? "";
  const isRecitation = finishReason === "RECITATION";
 
  // ストリーミング中に発火した場合、partial にはそこまでの生成が残っている
  const partial = (candidate.content?.parts ?? [])
    .map((p: { text?: string }) => p.text ?? "")
    .join("");
 
  return {
    isRecitation,
    partial,
    citationMetadata: candidate.citationMetadata,
  };
}

citationMetadata を返すこともあり、ここに「どの公開ソースの引用と判定したか」のヒントが入ります。私のパイプラインでは、これをログに残しておき、後で「どの依頼が引っかかったか」をデバッグできるようにしています。

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

この記事の続きを読む

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

この記事で得られること
Recitation block が発火する5つの典型条件を、API レスポンスの finishReason / citationMetadata と一緒に切り分けられるようになります
プロンプトの書き換えで発火率を 9割以上下げる「言い換え強制プロンプト」のテンプレートと、TypeScript のポストプロセスコードを持ち帰れます
自動投稿パイプラインで実装したリトライハンドラと、それでも止まるケースの最終手段(モデル切替・チャンク分割)の判断基準を共有します
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

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

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

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

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

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

関連記事

API / SDK2026-04-24
Gemini API Safety Settings の本番運用設計 — 誤ブロックを最小化しつつ悪意ある入力を止めるレイヤード・モデレーション
Gemini API の Safety Settings だけに依存すると、正当な質問が誤ブロックされたり、プロンプトを工夫した悪意のある入力が通ったりします。本番で耐えられる 4 層モデレーション設計を解説します。
API / SDK2026-07-18
同じ gemini-flash-latest が、リージョンごとに違うモデルを指していた — 比較値が汚れる数日間の見つけ方
エイリアスの解決先はリージョン単位でロールアウトされます。同じ gemini-flash-latest を東京と us-central1 に投げると、数日だけ別のモデルが応答する。その間の比較値が無効になる理由と、1発のプローブで検知して比較を凍結する設計をまとめます。
API / SDK2026-07-06
Managed Agents を本番に上げる前に、固定シナリオで挙動を測る — 非決定的なエージェントに回帰スイートと段階昇格を敷く
公開プレビューの Managed Agents は隔離サンドボックスで自律的に動く分、プロンプトや設定を少し変えただけで挙動が静かにずれます。単発プロンプトのように出力を一度突き合わせるだけでは足りません。固定シナリオを何度も回して合格率で測る回帰ハーネスと、影→カナリア→全面の段階昇格、逸脱時の自動ロールバックまでを、動く Python とともに設計します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →