Primeros pasos

Esta guía te acompaña en tu primera inferencia con la API de GreatRouter.

1. Obtén tu clave API

Regístrate en el panel de GreatRouter para obtener tu clave API. Cada cuenta nueva incluye créditos gratuitos.

Configura la variable de entorno:

export GREAT_ROUTER_API_KEY="pk_live_..."

2. Haz tu primera solicitud

GreatRouter usa el endpoint /v1/auto/route para el enrutamiento automático de prompts. Envía tu prompt y la entrada del modelo; el router selecciona el mejor modelo.

Con curl

curl https://api.greatrouterai.com/v1/auto/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "¿Cuál es la capital de Francia?",
    "input": {
      "messages": [{"role": "user", "content": "¿Cuál es la capital de Francia?"}]
    }
  }'

Con Python

import requests

response = requests.post(
    "https://api.greatrouterai.com/v1/auto/route",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "¿Cuál es la capital de Francia?",
        "input": {
            "messages": [{"role": "user", "content": "¿Cuál es la capital de Francia?"}]
        },
    },
)

result = response.json()
print(result["result"]["choices"][0]["message"]["content"])

Con Node.js

const response = await fetch('https://api.greatrouterai.com/v1/auto/route', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.GREAT_ROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: '¿Cuál es la capital de Francia?',
    input: {
      messages: [{ role: 'user', content: '¿Cuál es la capital de Francia?' }],
    },
  }),
});

const result = await response.json();
console.log(result.result.choices[0].message.content);

3. Especifica un modelo directamente

Si prefieres un modelo concreto en lugar del enrutamiento automático, usa /v1/models/route con una consulta explícita:

curl https://api.greatrouterai.com/v1/models/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "text_generation",
    "input": {
      "model": "meta/llama-3.3-70b-instruct-fp8-fast",
      "messages": [{"role": "user", "content": "Explica la computación cuántica en 3 frases."}]
    }
  }'

Los IDs de modelo usan el formato proveedor/nombre-modelo. Explora todos los modelos en Modelos.

4. Explora más

Inicio rápido — más ejemplos, incluida generación de imágenes y enrutamiento con límite de costo
Referencia API — documentación completa de endpoints
Modelos — explora todos los modelos disponibles
Modelos y precios — catálogo y tarifas