Model Gemini | Dokumentasi 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)

Model Gemini menggunakan endpoint Chat Completions bersama. Halaman ini mencatat nilai model yang didukung dan kontrak percakapan teks.

text

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

Model yang Tersedia

Nilai `model`	JSON tanpa streaming	Streaming SSE
`gemini-3.6-flash`	Ya	Ya
`gemini-3.7-flash`	Ya	Ya
`gemini-3.8-flash`	Ya	Ya
`gemini-3.5-flash-lite`	Ya	Ya
`gemini-4-argon`	Ya	Ya

gemini-4-argon memerlukan deployment dan pengaktifan. Pencantumannya dalam referensi ini tidak mengonfirmasi ketersediaan produksi.

Nama model membedakan tingkatan produk; nama tersebut bukan SLA latensi, throughput, atau kualitas. Bandingkan model dengan beban kerja nyata Anda. Periksa GET https://api.apihop.ai/v1/models untuk memastikan ketersediaannya bagi kunci API Anda sebelum mengirim permintaan.

Autentikasi

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Permintaan Tanpa Streaming

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
}

Permintaan Streaming

json

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

Secara bawaan, endpoint ini mengembalikan satu respons JSON lengkap. Tetapkan stream: true secara eksplisit jika memerlukan streaming SSE.

Kolom Permintaan

modelstringwajib

Gunakan gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, gemini-3.5-flash-lite, atau gemini-4-argon.

messagesobject[]wajib

Pesan bergaya OpenAI Chat Completions. Setiap pesan berisi role dan content.

streambooleanBawaan: false

true mengembalikan SSE; false mengembalikan satu respons JSON lengkap.

max_tokensinteger

Batas maksimum token output opsional, berupa bilangan bulat positif. Hilangkan kolom ini untuk menggunakan nilai bawaan penyedia hulu bagi model yang dipilih. Bergantung pada model, anggaran ini dapat mencakup token penalaran dan teks akhir. Anggaran kecil dapat memotong jawaban atau habis sebelum teks akhir dihasilkan; menaikkannya dapat meningkatkan biaya.

max_completion_tokensinteger

Alternatif kompatibilitas opsional untuk max_tokens, dengan pertimbangan anggaran yang sama. Dukungan ditentukan oleh model yang dipilih; hilangkan kedua kolom untuk menggunakan nilai bawaan penyedia hulu.

Lihat Chat Completions Bersama untuk kolom bersama seperti temperature, top_p, frequency_penalty, presence_penalty, stop, dan n. Dukungan dan perilaku kolom opsional bergantung pada model yang dipilih; halaman ini tidak menjamin dukungan semua kolom bersama.

Respons Berhasil

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 dapat mencakup detail token penalaran opsional; klien harus dapat menangani ketiadaannya atau perbedaannya menurut model.

Catatan Penggunaan

model dalam isi permintaan harus berupa salah satu ID model publik yang tercantum dalam tabel Model yang Tersedia.
Nama produk, nama tampilan, dan alias lainnya tidak diterima sebagai pengganti ID model publik.
Halaman ini hanya berlaku untuk permintaan Chat Completions yang dikirim ke

POST https://api.apihop.ai/v1/chat-completions, bukan OpenAI Responses atau Claude Messages.

Gunakan GET https://api.apihop.ai/v1/models untuk melihat model yang tersedia bagi kunci API saat ini, dan gunakan konsol untuk harga terkini.