Gemini API Python エラーコード別対処ガイド — Antigravity 開発で詰まる RESOURCE_EXHAUSTED・SAFETY・INVALID_ARGUMENT の解決策

import google.generativeai as genai
from google.api_core import exceptions as google_exceptions
 
genai.configure(api_key="YOUR_GEMINI_API_KEY")
model = genai.GenerativeModel("gemini-2.5-flash")
 
try:
    response = model.generate_content("こんにちは")
    print(response.text)
except google_exceptions.ResourceExhausted as e:
    print(f"クォータ超過: {e}")
except google_exceptions.InvalidArgument as e:
    print(f"リクエスト形式エラー: {e}")
except google_exceptions.DeadlineExceeded as e:
    print(f"タイムアウト: {e}")
except google_exceptions.PermissionDenied as e:
    print(f"認証エラー: {e}")
except Exception as e:
    print(f"その他のエラー: {type(e).__name__}: {e}")

import time
import random
import google.generativeai as genai
from google.api_core import exceptions as google_exceptions
 
def generate_with_retry(model, prompt, max_retries=5):
    """指数バックオフ付きの generate_content"""
    for attempt in range(max_retries):
        try:
            return model.generate_content(prompt)
        except google_exceptions.ResourceExhausted as e:
            if attempt == max_retries - 1:
                raise  # 最終試行でも失敗したら例外を投げる
            wait_time = (2 ** attempt) + random.uniform(0, 1)
            print(f"クォータ超過。{wait_time:.1f}秒後にリトライ ({attempt + 1}/{max_retries})")
            time.sleep(wait_time)
 
model = genai.GenerativeModel("gemini-2.5-flash")
response = generate_with_retry(model, "テスト")
print(response.text)

# ❌ こうするとエラー（バイト列をそのまま渡している）
with open("image.jpg", "rb") as f:
    image_bytes = f.read()
 
response = model.generate_content(["この画像は何ですか？", image_bytes])
# → INVALID_ARGUMENT: Request contains an invalid argument.
 
# ✅ 正しい書き方（PIL を使う）
import PIL.Image
image = PIL.Image.open("image.jpg")
response = model.generate_content(["この画像は何ですか？", image])
print(response.text)

response = model.generate_content(prompt)
 
# ❌ safety フィルターが発動していても気づかずアクセスしてしまう
print(response.text)  # → ValueError: response.text quick accessor only works when...
 
# ✅ finish_reason を確認してから使う
if response.candidates[0].finish_reason.name == "STOP":
    print(response.text)
elif response.candidates[0].finish_reason.name == "SAFETY":
    print("安全フィルターによりブロックされました")
    # safety_ratings を確認して原因カテゴリを特定する
    for rating in response.candidates[0].safety_ratings:
        if rating.probability.name not in ("NEGLIGIBLE", "LOW"):
            print(f"  カテゴリ: {rating.category.name}, 確率: {rating.probability.name}")
else:
    print(f"生成停止理由: {response.candidates[0].finish_reason.name}")

import google.generativeai as genai
 
genai.configure(api_key="YOUR_GEMINI_API_KEY")
model = genai.GenerativeModel("gemini-2.5-pro")
 
# 長い文章生成や推論タスクには 120〜300 秒が目安
response = model.generate_content(
    "以下のコードベースをリファクタリングして...",
    request_options={"timeout": 180}  # 3分
)
print(response.text)

# ストリーミングで長文生成
for chunk in model.generate_content("長い記事を書いて...", stream=True):
    print(chunk.text, end="", flush=True)
print()  # 最後に改行

import os
import google.generativeai as genai
 
# 環境変数から API キーを取得（コードに直書きしない）
api_key = os.environ.get("GEMINI_API_KEY")
if not api_key:
    raise ValueError("GEMINI_API_KEY 環境変数が設定されていません")
 
genai.configure(api_key=api_key)
model = genai.GenerativeModel("gemini-2.5-flash")
response = model.generate_content("テスト")
print(response.text)

import traceback
from google.api_core import exceptions as google_exceptions
 
try:
    response = model.generate_content(prompt)
    print(response.text)
except google_exceptions.GoogleAPIError as e:
    # 詳細情報をすべて出力する
    print(f"エラー種別: {type(e).__name__}")
    print(f"gRPC ステータスコード: {e.grpc_status_code}")
    print(f"メッセージ: {e.message}")
    print(f"トレースバック:\n{traceback.format_exc()}")