Gemini 3.1 Pro Preview · Completado de chat

POST/v1/chat/completions

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

Authorization: Bearer ****************

Parámetros de header

Content-TypestringOpcional

application/json

AcceptstringOpcional

application/json

Parámetros de bodyapplication/jsonobligatorio

modelstringObligatorio

ID del modelo, fijo en `gemini-3.1-pro-preview`

messagesarray[object]Obligatorio

Lista de mensajes de la conversación; cada uno tiene `role` (system / user / assistant) y `content`

streamboolOpcional

Si se transmite la respuesta (SSE), por defecto `false`

temperaturenumberOpcional

Temperatura de muestreo; cuanto mayor, más aleatorio

top_pnumberOpcional

Muestreo por núcleo; alternativa a `temperature`. Rango `0`–`1`

max_tokensintOpcional

Número máximo de tokens generados

nintOpcional

Número de respuestas a generar, por defecto `1`

stoparrayOpcional

Secuencias de parada; la salida se detiene al alcanzar cualquiera

presence_penaltynumberOpcional

Penaliza tokens ya presentes para favorecer la novedad. Rango `-2`–`2`

frequency_penaltynumberOpcional

Penaliza tokens por frecuencia para reducir repeticiones. Rango `-2`–`2`

reasoning_effortstringOpcional

Profundidad de razonamiento en modelos de pensamiento: `low` / `medium` / `high`

toolsarrayOpcional

Definiciones de herramientas / funciones (function calling)

tool_choicestring/objectOpcional

Si se llama a una herramienta y cuál: `auto` / `none` / una herramienta concreta

response_formatobjectOpcional

Restringe el formato de salida, p. ej. forzar un objeto JSON

extra_bodyobjectOpcional

Opciones específicas del proveedor como `thinking_config`, pasadas vía `extra_body`

Ejemplo

{
  "model": "gemini-3.1-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "Hola, cuéntame sobre ti"
    }
  ]
}

{  "model": "gemini-3.1-pro-preview",  "messages": [    {      "role": "user",      "content": "Hola, cuéntame sobre ti"    }  ]}

Código de ejemplo

curl https://api.hotrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [
      {
        "role": "user",
        "content": "Hola, cuéntame sobre ti"
      }
    ]
  }'

curl https://api.hotrouter.ai/v1/chat/completions \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-3.1-pro-preview",    "messages": [      {        "role": "user",        "content": "Hola, cuéntame sobre ti"      }    ]  }'

Respuesta

200 · Éxito

idstringObligatorio

Id único de esta respuesta

objectstringObligatorio

Tipo de objeto

createdintegerObligatorio

Marca de tiempo de creación (segundos)

modelstringObligatorio

Modelo realmente usado

choicesarray[object]Obligatorio

Lista de resultados generados

usageobjectObligatorio

Uso de tokens de esta llamada

Ejemplo

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gemini-3.1-pro-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "¡Hola! Encantado de conocerte…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 24,
    "total_tokens": 36
  }
}

{  "id": "chatcmpl-xxx",  "object": "chat.completion",  "created": 1730000000,  "model": "gemini-3.1-pro-preview",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "¡Hola! Encantado de conocerte…"      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 12,    "completion_tokens": 24,    "total_tokens": 36  }}

Gemini 3.1 Pro Preview · Completado de chat

Parámetros de solicitud

Código de ejemplo

Respuesta

On this page