Tu primera solicitud en 5 minutos
Inicia sesión, crea una clave, consulta modelos y envía una solicitud.
Prepara tu clave API
Inicia sesión en /login y crea o copia una clave API en /keys. La contraseña y el token de sesión no son claves API. Comprueba la validez, permisos del grupo y saldo en Dashboard.
Guarda la clave completa en la variable de entorno del servidor HANROUTER_API_KEY. No la incluyas en código del navegador, repositorios públicos ni parámetros URL.
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.
curl "https://api.hanrouter.ai/v1/models" \
-H "Authorization: Bearer $HANROUTER_API_KEY"Llama a un modelo
Instala el paquete openai y configura HANROUTER_MODEL con un ID devuelto por el endpoint anterior.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["HANROUTER_API_KEY"],
base_url="https://api.hanrouter.ai/v1",
)
model_id = os.environ["HANROUTER_MODEL"]
result = client.chat.completions.create(
model=model_id,
messages=[{"role": "user", "content": "Hello"}],
)
print(result.choices[0].message.content)