Gemini modelleri | API Belgeleri

# 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 modelleri ortak Chat Completions uç noktasını kullanır. Bu sayfa desteklenen model değerlerini ve metin sohbeti sözleşmesini kaydeder.

text

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

Kullanılabilir modeller

`model` değeri	Akışsız JSON	SSE akışı
`gemini-3.6-flash`	Evet	Evet
`gemini-3.7-flash`	Evet	Evet
`gemini-3.8-flash`	Evet	Evet
`gemini-3.5-flash-lite`	Evet	Evet
`gemini-4-argon`	Evet	Evet

gemini-4-argon dağıtım ve etkinleştirme gerektirir. Referansta bulunması üretimde kullanılabilirliğini doğrulamaz.

Model adları ürün seviyelerini ayırır; gecikme, iş hacmi veya kalite SLA’sı değildir. Modelleri gerçek iş yükünüzle karşılaştırın. İstek öncesinde GET https://api.apihop.ai/v1/models ile anahtarınıza kullanılabilirliği kontrol edin.

Kimlik doğrulama

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Akışsız istek

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
}

Akış isteği

json

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

Bu uç nokta varsayılan olarak tek bir tam JSON yanıtı döndürür. SSE akışı gerektiğinde stream: true değerini açıkça ayarlayın.

İstek alanları

modelstringzorunlu

gemini-3.6-flash veya gemini-3.7-flash veya gemini-3.8-flash veya gemini-3.5-flash-lite veya gemini-4-argon kullanın.

messagesobject[]zorunlu

OpenAI Chat Completions tarzı mesajlar. Her mesaj role ve content içerir.

streambooleanVarsayılan: false

true SSE döndürür; false tek bir tam JSON yanıtı döndürür.

max_tokensinteger

Pozitif tamsayı olarak isteğe bağlı azami çıktı tokenı. Seçilen modelin üst sağlayıcı varsayılanını kullanmak için atlayın. Modele göre bütçe, akıl yürütme tokenlarını ve son metni kapsayabilir. Küçük bütçe yanıtı kesebilir veya son metinden önce tükenebilir; artırmak maliyeti yükseltebilir.

max_completion_tokensinteger

Aynı bütçe hususlarıyla max_tokens için isteğe bağlı uyumluluk alternatifi. Desteği seçilen model belirler; üst varsayılanı kullanmak için iki alanı da atlayın.

temperature, top_p, frequency_penalty, presence_penalty, stop ve n gibi ortak alanlar için Ortak Chat Completions belgesine bakın. İsteğe bağlı alan desteği ve davranışı modele bağlıdır; bu sayfa tüm ortak alanları garanti etmez.

Başarılı yanıt

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 isteğe bağlı akıl yürütme tokenı ayrıntıları içerebilir; istemciler yokluğunu veya modele göre değişmesini tolere etmelidir.

Kullanım notları

Gövdenin model değeri kullanılabilir modeller tablosundaki açık ID’lerden biri olmalıdır.
Ürün adları, görünen adlar veya takma adlar açık model ID’sinin yerine kabul edilmez.
Sayfa yalnızca POST https://api.apihop.ai/v1/chat-completions adresine gönderilen Chat Completions istekleri için geçerlidir; OpenAI Responses veya Claude Messages için değil.
Mevcut anahtara görünen modeller için GET https://api.apihop.ai/v1/models, güncel fiyatlar için konsolu kullanın.