Gemini
Gemini 2.5 Flash · Completado de chat
Texto / Gemini / Gemini 2.5 Flash / Completado de chat
POST
/v1/chat/completionsPará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-2.5-flash`
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-2.5-flash", "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-2.5-flash", "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-2.5-flash", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "¡Hola! Encantado de conocerte…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36 }}