トラブルシューティング ガイド

Python Go

このガイドでは、Gemini API の呼び出し時に発生する一般的な問題の診断と解決に役立つ情報を説明します。Gemini API バックエンド サービスまたはクライアント SDK で問題が発生することがあります。クライアント SDK は、次のリポジトリでオープンソースとして公開されています。

• python-genai
• js-genai
• generative-ai-go

API キーに関する問題が発生した場合は、API キーの設定ガイドに沿って API キーが正しく設定されていることを確認してください。

Gemini API バックエンド サービスのエラーコード

次の表に、発生する可能性のある一般的なバックエンド エラーコードと、その原因の説明、トラブルシューティングの手順を示します。

クライアント SDK エラーコード

次の表に、発生する可能性のある一般的な Python クライアント SDK エラーコードと、その原因の説明を示します。

すべてのエラーは errors クラスにも表示されます。

SDK によって発生したエラーを処理するには、try-except ブロックを使用します。

from google.genai import errors

try:
    client.models.generate_content(
        model="invalid-model-name",
        contents="What is your name?",
    )
except errors.APIError as e:
    print(e.code) # 404
    print(e.message)

API 呼び出しでモデル パラメータのエラーを確認する

モデル パラメータが次の値の範囲内であることを確認します。

パラメータ値を確認するだけでなく、正しい API バージョン（/v1 または /v1beta）と、必要な機能をサポートするモデルを選択します。たとえば、機能がベータ版リリース中の場合は、/v1beta API バージョンでのみ使用できます。

適切なモデルを使用しているかどうかを確認する

モデルのページに記載されているサポート対象のモデルを使用していることを確認します。

安全性に関する問題

API 呼び出しの安全設定が原因でプロンプトがブロックされている場合は、API 呼び出しで設定したフィルタに照らし合わせてプロンプトを確認します。

BlockedReason.OTHER が表示された場合は、クエリまたはレスポンスが利用規約に違反しているか、サポートされていない可能性があります。

朗読に関する問題

RECITATION の理由でモデルの出力生成が停止した場合、モデルの出力が特定のデータに似ている可能性があります。これを解決するには、プロンプトやコンテキストをできるだけ一意にし、温度を高くします。

モデルの出力を改善する

モデルの出力の品質を高めるには、より構造化されたプロンプトの作成を検討してください。プロンプト設計の概要のページでは、プロンプトの設計を開始するための基本的なコンセプト、戦略、ベスト プラクティスについて説明します。

適切な入出力ペアの例が数百ある場合は、モデル チューニングも検討できます。

トークンの上限について

トークンのカウント方法と上限について詳しくは、トークン ガイドをご覧ください。

既知の問題

• この API は、一部の言語のみをサポートしています。サポートされていない言語でプロンプトを送信すると、予期しないレスポンスやブロックされたレスポンスが返される可能性があります。最新情報については、対応言語をご覧ください。

バグを報告

ご不明な点がございましたら、Google AI デベロッパー フォーラムでディスカッションに参加してください。