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.

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

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

Artículos relacionados

Crear y gestionar claves API ›