Skip to main content
Google Gemini は非常に強力な AI 対話システムで、提示されたキーワードを入力するだけで、数秒以内に流暢で自然な返信を生成できます。Gemini は驚くべき知能支援を提供し、人間の作業効率と創造性を大幅に向上させます。 この文書では、Gemini Chat Completion API 操作の使用プロセスについて説明します。これを利用することで、公式の Gemini の対話機能を簡単に使用できます。

申請プロセス

Gemini Chat Completion API を使用するには、まず Gemini Chat Completion API ページにアクセスし、「Acquire」ボタンをクリックして、リクエストに必要な資格情報を取得します: まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、この API を無料で使用できます。

基本使用

次に、画面上に対応する内容を入力します。以下の図のように:

このインターフェースを初めて使用する際には、少なくとも3つの内容を入力する必要があります。一つは authorization で、ドロップダウンリストから直接選択できます。もう一つのパラメータは model で、model は Gemini 公式モデルのカテゴリを選択するものです。ここでは主に6種類のモデルがあります。詳細は提供されたモデルをご覧ください。最後のパラメータは messages で、messages は入力する質問の配列です。これは配列で、複数の質問を同時にアップロードでき、各質問には rolecontent が含まれています。role は質問者の役割を示し、私たちは userassistantsystem の3つの役割を提供しています。もう一つの content は私たちの具体的な質問内容です。 また、右側には対応する呼び出しコードが生成されていることに注意してください。コードをコピーして直接実行することも、直接「Try」ボタンをクリックしてテストすることもできます。

呼び出し後、返された結果は以下の通りです:
返された結果には複数のフィールドがあり、以下のように説明されます:
  • id は、今回の対話タスクを一意に識別するための ID です。
  • model は、選択した Gemini 公式モデルです。
  • choices は、Gemini が質問に対して提供した回答情報です。
  • usage は、今回の問答に対するトークンの統計情報です。
その中で choices は Gemini の回答情報を含んでおり、choices の中には Gemini の具体的な回答情報が含まれています。以下の図のように確認できます。

choices の中の content フィールドには、Gemini の返信の具体的な内容が含まれています。

ストリーミング応答

このインターフェースはストリーミング応答もサポートしており、ウェブページとの接続に非常に便利で、ウェブページで逐字表示効果を実現できます。 ストリーミング応答を返したい場合は、リクエストヘッダーの stream パラメータを true に変更します。 変更は以下の図のように行いますが、呼び出しコードもストリーミング応答をサポートするために対応する変更が必要です。

streamtrue に変更すると、API は対応する JSON データを行ごとに返します。コードレベルで逐行の結果を得るために、相応の変更を行う必要があります。 Python のサンプル呼び出しコード:
出力結果は以下の通りです:
見ることができるように、choices に含まれる情報は基本的に使用される内容と一致しており、これはGeminiが複数の対話に対して応答する具体的な内容を含んでいるため、複数の対話内容に基づいて対応する質問に答えることができます。

Gemini-3.0 マルチモーダルモデル

リクエストの例:
例の結果:
もちろん、動画のリンクを送信することもできます。具体的な入力は以下の通りです:
例の結果:
上記から、Gemini 3.0モデルが多モーダルの理解をサポートしていることがわかります。

Gemini-3.1 多モーダルモデル

Gemini 3.1 ProはGemini 3.0 Proのアップグレード版で、基盤モデルはgemini-3.1-pro-previewであり、同様にテキスト、画像、動画などの多モーダル入力をサポートし、より強力な推論と理解能力を備えています。使用方法はGemini 3.0 Proと完全に一致し、modelパラメータをgemini-3.1-proに置き換えるだけで済みます。 リクエストの例:
Gemini 3.1 Proも動画理解をサポートしています:
返却フォーマットはGemini 3.0 Proと一致し、詳細は上記のGemini-3.0多モーダルモデルの章の説明を参照してください。

エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば:
  • 400 token_mismatched:不正なリクエスト、パラメータが欠落または無効である可能性があります。
  • 400 api_not_implemented:不正なリクエスト、パラメータが欠落または無効である可能性があります。
  • 401 invalid_token:未認証、無効または欠落した認証トークン。
  • 429 too_many_requests:リクエストが多すぎます、レート制限を超えました。
  • 500 api_error:内部サーバーエラー、サーバーで何かがうまくいきませんでした。

エラー応答の例

結論

この文書を通じて、Gemini Chat Completion APIを使用して公式Geminiの対話機能を簡単に実現する方法を理解しました。この文書が、APIの接続と使用をより良くする手助けとなることを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。