Gemini APIで「FAILED_PRECONDITION」エラーが出る — ケース別の原因診断と解決策

import google.generativeai as genai
 
try:
    genai.configure(api_key="YOUR_API_KEY")
    model = genai.GenerativeModel("gemini-2.5-pro")
    response = model.generate_content("Hello")
    print(response.text)
except Exception as e:
    # エラーの詳細を確認する
    print(f"Error type: {type(e).__name__}")
    print(f"Error message: {str(e)}")
    # "Billing account not found" が含まれていればケース1
    if "billing" in str(e).lower():
        print("→ 課金設定の問題です")

# Cloud SDKでAPIの有効化状態を確認
gcloud services list --enabled | grep generativelanguage
 
# 有効化されていない場合
gcloud services enable generativelanguage.googleapis.com

# Vertex AI APIも有効化が必要
gcloud services enable aiplatform.googleapis.com

import google.generativeai as genai
 
# ❌ 短すぎるコンテンツはキャッシュ不可
short_content = "これは短いシステム指示です。"  # 数十トークン
 
try:
    cache = genai.caching.CachedContent.create(
        model="gemini-2.5-pro",
        system_instruction=short_content,  # 32,768トークン未満でエラー
    )
except Exception as e:
    print(e)  # FAILED_PRECONDITION: ...minimum token count...
 
# ✅ 十分なコンテンツ量を確保する
# 実用的にはPDFや長文ドキュメントに使うのがコンテキストキャッシュの正しい用途

import google.generativeai as genai
from datetime import datetime
 
def get_or_recreate_cache(cache_name, model, content, ttl_seconds=3600):
    """キャッシュが期限切れなら再作成するユーティリティ"""
    try:
        # 既存のキャッシュを参照してリクエスト
        model_with_cache = genai.GenerativeModel.from_cached_content(
            cached_content=cache_name
        )
        response = model_with_cache.generate_content("質問")
        return response
    except Exception as e:
        if "expired" in str(e).lower() or "FAILED_PRECONDITION" in str(e):
            print("キャッシュが期限切れです。再作成します...")
            # キャッシュを再作成
            new_cache = genai.caching.CachedContent.create(
                model=model,
                contents=content,
                ttl={"seconds": ttl_seconds}
            )
            model_with_cache = genai.GenerativeModel.from_cached_content(
                cached_content=new_cache
            )
            return model_with_cache.generate_content("質問")
        raise  # その他のエラーは再スロー

import google.generativeai as genai
from google.api_core import exceptions as google_exceptions
import time
 
def call_gemini_with_error_handling(prompt: str, max_retries: int = 1) -> str:
    """
    FAILED_PRECONDITIONを適切にハンドリングするラッパー
    - 課金・API有効化のエラー: 即座に終了（リトライ不可）
    - キャッシュ期限切れ: 再試行ロジックを別途実装
    - その他: エラーメッセージをログに残す
    """
    genai.configure(api_key="YOUR_API_KEY")
    model = genai.GenerativeModel("gemini-2.5-pro")
    
    for attempt in range(max_retries + 1):
        try:
            response = model.generate_content(prompt)
            return response.text
            
        except google_exceptions.FailedPrecondition as e:
            error_msg = str(e)
            
            # 課金・API設定の問題 → リトライ不要
            if any(keyword in error_msg.lower() for keyword in 
                   ["billing", "not enabled", "not available for general access"]):
                raise RuntimeError(
                    f"設定の問題です（リトライ不可）: {error_msg}\n"
                    "Google Cloud Console で課金設定とAPIの有効化を確認してください。"
                ) from e
            
            # キャッシュ期限切れ → 上位ロジックで再作成が必要
            if "expired" in error_msg.lower():
                raise RuntimeError(
                    "コンテキストキャッシュが期限切れです。キャッシュを再作成してください。"
                ) from e
            
            # その他のFAILED_PRECONDITION
            if attempt < max_retries:
                print(f"予期しないFAILED_PRECONDITION: {error_msg}")
                print(f"30秒後にリトライします... ({attempt + 1}/{max_retries})")
                time.sleep(30)
            else:
                raise
    
    return ""  # 到達しない（型チェック用）