Gemini-Modelle | API-Dokumentation

# 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-Modelle verwenden den gemeinsamen Chat-Completions-Endpunkt. Diese Seite beschreibt unterstützte model-Werte und den Vertrag für Textchats.

text

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

Verfügbare Modelle

`model`-Wert	JSON ohne Streaming	SSE-Streaming
`gemini-3.6-flash`	Ja	Ja
`gemini-3.7-flash`	Ja	Ja
`gemini-3.8-flash`	Ja	Ja
`gemini-3.5-flash-lite`	Ja	Ja
`gemini-4-argon`	Ja	Ja

gemini-4-argon erfordert Bereitstellung und Aktivierung. Der Eintrag in dieser Referenz bestätigt keine Verfügbarkeit in Produktion.

Modellnamen unterscheiden Produktstufen; sie sind keine SLAs für Latenz, Durchsatz oder Qualität. Vergleichen Sie Modelle anhand Ihrer tatsächlichen Arbeitslast. Prüfen Sie vor einer Anfrage mit GET https://api.apihop.ai/v1/models die Verfügbarkeit für Ihren Schlüssel.

Authentifizierung

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Anfrage ohne 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
}

Streaming-Anfrage

json

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

Dieser Endpunkt liefert standardmäßig eine vollständige JSON-Antwort. Setzen Sie stream: true ausdrücklich, wenn Sie SSE-Streaming benötigen.

Anfragefelder

modelstringerforderlich

Verwenden Sie gemini-3.6-flash oder gemini-3.7-flash oder gemini-3.8-flash oder gemini-3.5-flash-lite oder gemini-4-argon.

messagesobject[]erforderlich

Nachrichten im Stil von OpenAI Chat Completions. Jede Nachricht enthält role und content.

streambooleanStandard: false

true liefert SSE; false liefert eine vollständige JSON-Antwort.

max_tokensinteger

Optionale maximale Ausgabetokens als positive Ganzzahl. Lassen Sie das Feld weg, um den Standard des Anbieters für das gewählte Modell zu verwenden. Je nach Modell umfasst das Budget Denktokens und endgültigen Text. Ein kleines Budget kann die Antwort abschneiden oder vor dem endgültigen Text aufgebraucht sein; eine Erhöhung kann die Kosten steigern.

max_completion_tokensinteger

Optionale Kompatibilitätsalternative zu max_tokens mit denselben Budgetaspekten. Das ausgewählte Modell bestimmt die Unterstützung; lassen Sie beide Felder weg, um den Anbieterstandard zu verwenden.

Gemeinsame Felder wie temperature, top_p, frequency_penalty, presence_penalty, stop und n stehen unter Gemeinsame Chat Completions. Unterstützung und Verhalten optionaler Felder hängen vom gewählten Modell ab; diese Seite garantiert nicht jedes gemeinsame Feld.

Erfolgreiche Antwort

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 kann optionale Details zu Denktokens enthalten; Clients müssen deren Fehlen oder Unterschiede je nach Modell tolerieren.

Nutzungshinweise

model im Anfrageinhalt muss eine der öffentlichen IDs aus der Tabelle verfügbarer Modelle sein.
Produktnamen, Anzeigenamen und andere Aliasse werden nicht anstelle einer öffentlichen Modell-ID akzeptiert.
Diese Seite gilt nur für Chat-Completions-Anfragen an POST https://api.apihop.ai/v1/chat-completions, nicht für OpenAI Responses oder Claude Messages.
Verwenden Sie GET https://api.apihop.ai/v1/models für die dem aktuellen Schlüssel sichtbaren Modelle und die Konsole für aktuelle Preise.