Modèles Gemini | Documentation des 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)

Les modèles Gemini utilisent l’endpoint Chat Completions commun. Cette page décrit les valeurs de model prises en charge et le contrat du chat textuel.

text

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

Modèles disponibles

Valeur de `model`	JSON sans streaming	Streaming SSE
`gemini-3.6-flash`	Oui	Oui
`gemini-3.7-flash`	Oui	Oui
`gemini-3.8-flash`	Oui	Oui
`gemini-3.5-flash-lite`	Oui	Oui
`gemini-4-argon`	Oui	Oui

gemini-4-argon nécessite un déploiement et une activation. Sa présence dans cette référence ne confirme pas sa disponibilité en production.

Les noms de modèles distinguent des niveaux de produit ; ils ne constituent pas des SLA de latence, de débit ou de qualité. Comparez les modèles sur votre charge réelle. Consultez GET https://api.apihop.ai/v1/models pour vérifier la disponibilité pour votre clé avant d’envoyer une requête.

Authentification

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Requête sans 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
}

Requête avec streaming

json

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

Cet endpoint renvoie par défaut une réponse JSON complète. Définissez explicitement stream: true lorsque vous souhaitez le streaming SSE.

Champs de requête

modelstringobligatoire

Utilisez gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, gemini-3.5-flash-lite ou gemini-4-argon.

messagesobject[]obligatoire

Messages au format OpenAI Chat Completions. Chaque message contient role et content.

streambooleanPar défaut: false

true renvoie SSE ; false renvoie une réponse JSON complète.

max_tokensinteger

Nombre maximal facultatif de tokens de sortie, sous forme d’entier positif. Omettez ce champ pour utiliser la valeur par défaut du fournisseur pour le modèle choisi. Selon le modèle, ce budget peut inclure les tokens de raisonnement et le texte final. Un petit budget peut tronquer la réponse ou être épuisé avant le texte final ; l’augmenter peut accroître le coût.

max_completion_tokensinteger

Alternative de compatibilité facultative à max_tokens, avec les mêmes considérations de budget. Le modèle choisi détermine sa prise en charge ; omettez les deux champs pour utiliser la valeur par défaut du fournisseur.

Consultez Chat Completions commun pour les champs partagés tels que temperature, top_p, frequency_penalty, presence_penalty, stop et n. La prise en charge et le comportement des champs optionnels dépendent du modèle choisi ; cette page ne garantit pas chaque champ partagé.

Réponse réussie

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 peut inclure des détails facultatifs de tokens de raisonnement ; les clients doivent tolérer leur absence ou leurs différences selon le modèle.

Notes d’utilisation

Le champ model du corps de requête doit être l’un des ID publics indiqués dans le tableau des modèles disponibles.
Les noms de produit, noms affichés et autres alias ne sont pas acceptés à la place d’un ID public.
Cette page s’applique uniquement aux requêtes Chat Completions envoyées à POST https://api.apihop.ai/v1/chat-completions, pas à OpenAI Responses ou Claude Messages.
Utilisez GET https://api.apihop.ai/v1/models pour les modèles visibles par la clé API actuelle et la console pour les tarifs actuels.