Skip to main content
Google Gemini は非常に強力な AI 対話システムです。プロンプトを入力するだけで、わずか数秒で流暢かつ自然な応答を生成できます。Gemini は驚異的な知的支援を提供し、人間の作業効率と創造性を大幅に向上させます。 本ドキュメントでは主に Gemini Chat Completion API の操作使用フローを紹介します。これを利用することで、公式 Gemini の対話機能を簡単に使用できます。

申請フロー

Gemini Chat Completion API を使用するには、まず Ace Data Cloud コンソール にアクセスして API Token を取得し、予備として保管してください。 まだログインまたは登録していない場合は、ログインページへ自動的にリダイレクトされ、登録とログインを促されます。完了後は自動的に現在のページへ戻ります。 1 つの API Token でプラットフォーム上のすべてのサービスを呼び出せるため、サービスごとに個別申請する必要はありません。 初回申請時には無料枠が付与され、無料で体験できます。残高が不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント:Gemini Chat Completion API →

基本的な使用方法

次に、図のように画面上で対応する内容を入力できます。

このインターフェースを初めて使用する際は、少なくとも 3 つの項目を入力する必要があります。1 つ目は authorization で、ドロップダウンリストから直接選択できます。もう 1 つのパラメータは model であり、model は Gemini 公式サイトのどのモデルカテゴリを使用するかを選択するものです。選択可能なモデルは、インターフェースドキュメント内の model 列挙を基準とします。最後のパラメータは messages で、messages は入力する質問文の配列です。これは配列であり、複数の質問文を同時にアップロードできることを示します。各質問文には role と content が含まれ、そのうち role は質問者の役割を表します。3 種類の役割を提供しており、それぞれ user、assistant、system です。もう一方の content は、質問する具体的な内容です。 同時に、右側には対応する呼び出しコードが生成されていることに気付くでしょう。コードをコピーして直接実行することも、「Try」ボタンを直接クリックしてテストすることもできます。

ヒント:gemini-3.x シリーズの flash は思考モデルであり、先に reasoning tokens を消費します。max_tokens を 512 以上に設定してください。そうしないと、空の内容しか返されない可能性があります。gemini-3.8-flash は現在推奨されている Flash モデルで、最大 100 万 Token のコンテキスト、画像入力、ツール呼び出し、ストリーミング応答をサポートしています。現在は Chat Completions インターフェースを通じて呼び出します。
呼び出し後、返される結果は以下のとおりです。
返される結果には複数のフィールドがあり、以下のとおりです。
  • id:今回の対話タスクを生成する ID であり、今回の対話タスクを一意に識別するために使用されます。
  • model :選択した Gemini 公式サイトのモデル。
  • choices:Gemini が質問文に対して提供する回答情報。
  • usage :今回の質問応答における token の統計情報。
そのうち choices には Gemini の回答情報が含まれており、その中の choices は Gemini の回答の具体的な情報です。図のように確認できます。

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

画像理解(マルチモーダル入力)

Gemini はネイティブのマルチモーダルモデルであり、直接「画像を見る」ことができます。画像を渡すには、あるメッセージの content を文字列からコンテンツブロック配列に変更し、配列内に text ブロックと image_url ブロックを同時に配置するだけです——これは OpenAI、および公式 Gemini の OpenAI 互換形式と完全に一致します。 image_url.url は 2 種類の書き方をサポートしています。
  • base64 data: URI(推奨、最も安定):形式は data:<メディアタイプ>;base64,<データ> です。例:data:image/jpeg;base64,/9j/4AAQ...。メディアタイプ(MIME)はすでに data: プレフィックス内に記述されているため、個別の media_type フィールドは不要であり、存在もしません。
  • 公開アクセス可能な画像 URL:例:https://cdn.acedata.cloud/4hfydw.jpg。
対応する画像タイプ:png、jpeg、webp、heic、heif。 Python サンプル呼び出しコード(base64 data URI):
公開アクセス可能な画像 URL を直接渡すこともできます:
💡 image_url は url フィールド(値は画像 URL または base64 data: URI)と、任意の detail フィールドのみを受け付けます。media_type を渡さないでください——これは Anthropic Claude の画像フィールドであり、OpenAI / Gemini の image_url 形式には属しません。

ストリーミングレスポンス

このインターフェースはストリーミングレスポンスにも対応しており、Web ページとの連携に非常に役立ち、ページ上で一文字ずつ表示する効果を実現できます。 レスポンスをストリーミングで返したい場合は、リクエストヘッダー内の stream パラメータを変更し、true に設定できます。 図のように変更しますが、ストリーミングレスポンスに対応するには、呼び出しコードにも対応する変更が必要です。

stream を true に変更すると、API は対応する JSON データを行ごとに返します。コードレベルでは、行ごとの結果を取得するために対応する変更を行う必要があります。 Python サンプル呼び出しコード:
出力結果は以下のとおりです:
確認できるように、レスポンスには多数の data があり、data 内の choices が最新の回答内容であり、上記で紹介した内容と一致しています。choices は追加された回答内容であり、結果に基づいてご自身のシステムに連携できます。同時に、ストリーミングレスポンスの終了は data の内容によって判断されます。内容が [DONE] の場合、ストリーミングレスポンスの回答がすべて終了したことを示します。返される data の結果には複数のフィールドがあり、以下のとおりです:
  • id,今回の会話タスクの ID を生成し、今回の会話タスクを一意に識別するために使用します。
  • model ,選択した Gemini 公式サイトのモデル。
  • choices,Gemini が質問に対して提供する回答情報。
JavaScript もサポートされています。たとえば、Node.js のストリーミング呼び出しコードは以下のとおりです:
Java のサンプルコード:
その他の言語については別途ご自身で書き換えることができ、原理はすべて同じです。

複数ターンの会話

複数ターンの会話機能を連携したい場合は、messages フィールドに複数の質問をアップロードする必要があります。複数の質問の具体例は以下の図のとおりです:

Python のサンプル呼び出しコード:
複数の質問をアップロードすることで、複数ターンの会話を簡単に実現でき、以下のような回答を取得できます:
ご覧のとおり、choices に含まれる情報は基本的な使用方法の内容と一致しており、Gemini が複数の会話に対して返信する具体的な内容が含まれています。これにより、複数の会話内容に基づいて対応する質問に回答できます。

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

リクエスト例:
サンプル結果:
もちろん、動画のリンクを渡すこともできます。具体的な入力は以下のとおりです。
サンプル結果:
上記からわかるように、Gemini 3.0 モデルはマルチモーダルな理解をサポートできます。

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

gemini-3.1-pro-preview は現在の Gemini 3.1 Pro の公式モデル ID であり、テキスト、画像、動画などのマルチモーダル入力をサポートし、複雑な推論、コーディング、理解タスクに適しています。 リクエスト例:
Gemini 3.1 Pro は同様に動画理解もサポートしています:
返却形式は Gemini 3.0 Pro と同一です。詳細については、上記の Gemini-3.0 マルチモーダルモデルのセクションの説明を参照してください。

エラー処理

API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例:
  • 400 token_mismatched:Bad request、パラメータの欠落または無効が原因である可能性があります。
  • 400 api_not_implemented:Bad request、パラメータの欠落または無効が原因である可能性があります。
  • 401 invalid_token:Unauthorized、認証トークンが無効または欠落しています。
  • 429 too_many_requests:Too many requests、レート制限を超えています。
  • 500 api_error:Internal server error、サーバー側で問題が発生しました。

エラー応答の例

結論

本ドキュメントを通じて、Gemini Chat Completion API を使用して、公式 Gemini の対話機能を簡単に実装する方法をご理解いただけたと思います。本ドキュメントが、当該 API の連携および使用により役立つことを願っております。ご不明な点がございましたら、いつでも弊社の技術サポートチームまでお問い合わせください。