Gemini モデル | API ドキュメント

# Gemini Models

Call Gemini 3.6 Flash, 3.7 Flash, 3.8 Flash, 3.5 Flash-Lite, and 4 Argon through the shared Chat Completions endpoint.

POST https://api.apihop.ai/v1/chat-completions

Gemini models use the Common Chat Completions endpoint. This page records the supported `model` values and text chat contract.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Models

| `model` value | Non-streaming JSON | SSE streaming |
| --- | --- | --- |
| `gemini-3.6-flash` | Yes | Yes |
| `gemini-3.7-flash` | Yes | Yes |
| `gemini-3.8-flash` | Yes | Yes |
| `gemini-3.5-flash-lite` | Yes | Yes |
| `gemini-4-argon` | Yes | Yes |

`gemini-4-argon` requires deployment and enablement. Its inclusion in this reference does not confirm production availability.

Model names distinguish product tiers; they are not latency, throughput, or quality SLAs. Compare models with your real workload. Check `GET https://api.apihop.ai/v1/models` for availability to your API Key before making a request.

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

```json
{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}
```

## Streaming Request

```json
{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}
```

This endpoint returns one complete JSON response by default. Set `stream: true` explicitly when you need SSE streaming.

## Request Fields

### `model` (string, required)

Use `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-3.5-flash-lite`, or `gemini-4-argon`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

### `max_completion_tokens` (integer)

Optional compatibility alternative to `max_tokens`, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `stop`, and `n`. Support and behavior of optional fields depend on the selected model; this page does not guarantee every shared field.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}
```

`usage` may include optional reasoning-token details; clients should tolerate them being absent or changing by model.

## Usage Notes

- The request body's `model` must be one of the public model IDs listed in the Available Models table.
- Product names, display names, and other aliases are not accepted in place of a public model ID.
- This page applies only to Chat Completions requests sent to

`POST https://api.apihop.ai/v1/chat-completions`, not OpenAI Responses or Claude Messages.

- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

Gemini モデルは共通 Chat Completions エンドポイントを使用します。このページでは、対応する model の値とテキストチャットの仕様を説明します。

text

POST https://api.apihop.ai/v1/chat-completions

利用可能なモデル

`model` の値	非ストリーミング JSON	SSE ストリーミング
`gemini-3.6-flash`	対応	対応
`gemini-3.7-flash`	対応	対応
`gemini-3.8-flash`	対応	対応
`gemini-3.5-flash-lite`	対応	対応
`gemini-4-argon`	対応	対応

gemini-4-argon にはデプロイと有効化が必要です。このリファレンスへの掲載は、本番環境での利用可否を確認するものではありません。

モデル名は製品の区分を示すもので、レイテンシ、スループット、品質の SLA ではありません。実際のワークロードでモデルを比較してください。リクエストを行う前に、自分の API キーで利用できるか GET https://api.apihop.ai/v1/models で確認してください。

認証

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

非ストリーミングのリクエスト

json

{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}

ストリーミングのリクエスト

json

{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}

このエンドポイントは、既定では 1 つの完全な JSON レスポンスを返します。SSE ストリーミングが必要な場合は、stream: true を明示的に設定してください。

リクエストフィールド

modelstring必須

gemini-3.6-flash、gemini-3.7-flash、gemini-3.8-flash、gemini-3.5-flash-lite、gemini-4-argon のいずれかを使用してください。

messagesobject[]必須

OpenAI Chat Completions 形式のメッセージです。各メッセージには role と content が含まれます。

streamboolean既定値: false

true では SSE を、false では 1 つの完全な JSON レスポンスを返します。

max_tokensinteger

任意の最大出力トークン数で、正の整数を指定します。省略すると、選択したモデルの上流側の既定値を使用します。モデルによっては、予算に最終テキストだけでなく推論トークンも含まれます。予算が小さいと、回答が途中で切れたり、最終テキストの生成前に予算を使い切ったりする可能性があります。予算を増やすと費用が増える場合があります。

max_completion_tokensinteger

互換性のために用意された、任意の max_tokens の代替フィールドです。予算に関する注意事項は同じです。対応状況は選択したモデルによって決まります。両方を省略すると上流側の既定値を使用します。

temperature、top_p、frequency_penalty、presence_penalty、stop、n などの共通フィールドについては、共通 Chat Completionsを参照してください。任意フィールドの対応状況と動作は、選択したモデルによって異なります。このページは、すべての共通フィールドの対応を保証するものではありません。

成功時のレスポンス

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

usage には任意の推論トークンの詳細が含まれる場合があります。クライアントは、それらがない場合や、モデルによって異なる場合も処理できるようにしてください。

利用上の注意

リクエストボディの model には、「利用可能なモデル」の表に記載された公開モデル ID のいずれかを指定する必要があります。
公開モデル ID の代わりに、製品名、表示名、その他の別名を使用することはできません。
このページは POST https://api.apihop.ai/v1/chat-completions に送信する Chat Completions リクエストのみを対象とし、OpenAI Responses や Claude Messages は対象外です。
現在の API キーから見えるモデルは GET https://api.apihop.ai/v1/models で、最新の料金はコンソールで確認してください。