Modelos Gemini | Documentação de APIs

# 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)

Os modelos Gemini usam o endpoint Chat Completions comum. Esta página registra os valores model suportados e o contrato de chat de texto.

text

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

Modelos disponíveis

Valor de `model`	JSON sem streaming	Streaming SSE
`gemini-3.6-flash`	Sim	Sim
`gemini-3.7-flash`	Sim	Sim
`gemini-3.8-flash`	Sim	Sim
`gemini-3.5-flash-lite`	Sim	Sim
`gemini-4-argon`	Sim	Sim

gemini-4-argon exige implantação e ativação. Sua inclusão nesta referência não confirma disponibilidade em produção.

Os nomes distinguem níveis de produto; não são SLAs de latência, vazão ou qualidade. Compare com sua carga real. Consulte GET https://api.apihop.ai/v1/models para verificar disponibilidade para sua chave antes de solicitar.

Autenticação

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Solicitação sem 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
}

Solicitação com streaming

json

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

Este endpoint retorna uma resposta JSON completa por padrão. Defina stream: true explicitamente quando precisar de streaming SSE.

Campos da solicitação

modelstringobrigatório

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

messagesobject[]obrigatório

Mensagens no estilo OpenAI Chat Completions. Cada mensagem contém role e content.

streambooleanPadrão: false

true retorna SSE; false retorna uma resposta JSON completa.

max_tokensinteger

Máximo opcional de tokens de saída, como inteiro positivo. Omita para usar o padrão do provedor para o modelo escolhido. Dependendo do modelo, o orçamento pode incluir tokens de raciocínio e texto final. Um orçamento pequeno pode truncar a resposta ou acabar antes do texto final; aumentá-lo pode elevar o custo.

max_completion_tokensinteger

Alternativa opcional de compatibilidade a max_tokens, com as mesmas considerações de orçamento. O modelo escolhido determina o suporte; omita ambos os campos para usar o padrão do provedor.

Consulte Chat Completions comum para campos compartilhados como temperature, top_p, frequency_penalty, presence_penalty, stop e n. Suporte e comportamento dos campos opcionais dependem do modelo; esta página não garante todos os campos compartilhados.

Resposta bem-sucedida

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 pode incluir detalhes opcionais de tokens de raciocínio; clientes devem tolerar sua ausência ou variação por modelo.

Notas de uso

model no corpo deve ser um dos IDs públicos na tabela de modelos disponíveis.
Nomes de produto, nomes de exibição e aliases não substituem um ID público de modelo.
Esta página vale apenas para solicitações Chat Completions enviadas a POST https://api.apihop.ai/v1/chat-completions, não OpenAI Responses ou Claude Messages.
Use GET https://api.apihop.ai/v1/models para modelos visíveis à chave atual e o console para preços atuais.