Modelos Gemini | Documentación de 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)

Los modelos Gemini usan el endpoint Chat Completions común. Esta página recoge los valores admitidos de model y el contrato del chat de texto.

text

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

Modelos disponibles

Valor de `model`	JSON sin streaming	Streaming SSE
`gemini-3.6-flash`	Sí	Sí
`gemini-3.7-flash`	Sí	Sí
`gemini-3.8-flash`	Sí	Sí
`gemini-3.5-flash-lite`	Sí	Sí
`gemini-4-argon`	Sí	Sí

gemini-4-argon requiere despliegue y activación. Su inclusión en esta referencia no confirma su disponibilidad en producción.

Los nombres de modelos distinguen niveles de producto; no son SLA de latencia, rendimiento ni calidad. Compara los modelos con tu carga real. Consulta GET https://api.apihop.ai/v1/models para verificar la disponibilidad para tu clave antes de enviar una solicitud.

Autenticación

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Solicitud sin 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
}

Solicitud con streaming

json

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

Este endpoint devuelve una respuesta JSON completa de forma predeterminada. Establece stream: true explícitamente cuando necesites streaming SSE.

Campos de solicitud

modelstringobligatorio

Usa gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, gemini-3.5-flash-lite o gemini-4-argon.

messagesobject[]obligatorio

Mensajes al estilo OpenAI Chat Completions. Cada mensaje contiene role y content.

streambooleanPredeterminado: false

true devuelve SSE; false devuelve una respuesta JSON completa.

max_tokensinteger

Máximo opcional de tokens de salida, como entero positivo. Omite este campo para usar el valor predeterminado del proveedor para el modelo elegido. Según el modelo, el límite puede incluir tokens de razonamiento y texto final. Un límite pequeño puede truncar la respuesta o agotarse antes del texto final; aumentarlo puede incrementar el coste.

max_completion_tokensinteger

Alternativa opcional de compatibilidad a max_tokens, con las mismas consideraciones sobre el límite. El modelo elegido determina la compatibilidad; omite ambos campos para usar el valor predeterminado del proveedor.

Consulta Chat Completions común para campos compartidos como temperature, top_p, frequency_penalty, presence_penalty, stop y n. La compatibilidad y el comportamiento de los campos opcionales dependen del modelo elegido; esta página no garantiza todos los campos compartidos.

Respuesta correcta

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 puede incluir detalles opcionales de tokens de razonamiento; los clientes deben tolerar que falten o varíen según el modelo.

Notas de uso

El campo model del cuerpo debe ser uno de los ID públicos indicados en la tabla de modelos disponibles.
Los nombres de producto, nombres visibles y otros alias no se aceptan en lugar de un ID público del modelo.
Esta página se aplica solo a solicitudes de Chat Completions enviadas a POST https://api.apihop.ai/v1/chat-completions, no a OpenAI Responses ni Claude Messages.
Usa GET https://api.apihop.ai/v1/models para consultar los modelos visibles para la clave actual y la consola para los precios vigentes.