Chat completions · compatible con OpenAI

Llama a modelos de texto con mensajes unificados, streaming, herramientas y entradas multimodales cuando estén admitidas.

POST/v1/chat/completions
https://api.hanrouter.ai/v1Gestionar claves API

URL 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.

Ejemplo de solicitud
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
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

JSON · estructura de ejemplo
{
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}