Chat completions · compatible con OpenAI
Llama a modelos de texto con mensajes unificados, streaming, herramientas y entradas multimodales cuando estén admitidas.
/v1/chat/completionshttps://api.hanrouter.ai/v1Gestionar claves APIURL y autenticación
Usa https://api.hanrouter.ai/v1 como URL base compatible con OpenAI y Authorization: Bearer $HANROUTER_API_KEY. No dupliques /v1. Todos los fabricantes usan tu clave HanRouter, no una clave del proveedor.
Para Anthropic SDK y Claude Code usa https://api.hanrouter.ai sin /v1; el cliente añade /v1/messages. Usa la interfaz compatible con OpenAI para Google.
Verifica los modelos
Consulta primero los modelos disponibles y copia data[].id exactamente. Los nombres, mayúsculas y alias dependen de esa respuesta. La plaza oculta modelos sin precio, sin cambiar la disponibilidad del backend.
curl "https://api.hanrouter.ai/v1/models" \
-H "Authorization: Bearer $HANROUTER_API_KEY"Streaming y respuesta
Lee choices[0].message.content o tool_calls y devuelve resultados con role: tool. En streaming lee choices[].delta hasta [DONE]. Los parámetros varían; algunos modelos de razonamiento rechazan muestreo.
Parámetros
model- String obligatorio: ID exacto disponible para tu clave.
messages- Array obligatorio: mensajes con role y content.
stream- Boolean opcional: streaming SSE; por defecto false.
temperature- Número opcional: solo para modelos con temperatura.
max_completion_tokens- Entero opcional: límite de salida, puede incluir razonamiento.
tools- Array opcional: herramientas; la app ejecuta y devuelve resultados.
response_format- Object opcional: JSON u otro formato admitido.
Ejemplo de solicitud
Los ejemplos usan IDs configurados. Los permisos del grupo de la clave determinan el acceso; consulta GET /v1/models.
curl -X POST "https://api.hanrouter.ai/v1/chat/completions" \
-H "Authorization: Bearer $HANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Hello"
}
],
"stream": false
}'Ejemplo de respuesta
{
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 8,
"completion_tokens": 3,
"total_tokens": 11
}
}