Una línea de código y ya estás en la Unión Europea.

Quickstart: tu primera llamada a la API

Crea una clave en tu panel, en Ajustes, Claves API. El secreto lo ves una sola vez. Después solo guardamos un hash y el prefijo. Ponlo en una variable de entorno, nunca en tu repositorio.

curl https://api.europeanailab.eu/v1/chat/completions \
  -H "Authorization: Bearer $UNION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eu-standard",
    "messages": [{"role": "user", "content": "Explica la inversión del sujeto pasivo del IVA."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # la única línea que cambia
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Explica la inversión del sujeto pasivo del IVA."}],
)
print(resp.choices[0].message.content)

Tiers de modelo y ventanas de contexto

En el campo model pasas un tier, no un nombre de modelo. Así tu integración sigue funcionando cuando cambiemos el modelo de debajo, y lo haremos, porque los modelos open-weight se retiran y otros los superan.

Si superas la ventana de contexto de un tier, recibes un 400 con el máximo indicado: nunca recortamos tu prompt sin avisar.

Respuestas en streaming

El streaming funciona como esperas, con una diferencia importante que debes conocer porque afecta a tu dinero.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Escribe un resumen."}],
    stream=True,
    # Sin esto no hay objeto usage y no puedes ver el coste.
    stream_options={"include_usage": True},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:                      # último chunk
        print("\n", chunk.usage)

Si cortas un stream a medias, solo pagas lo generado hasta ese momento. Si por la conexión caída no llega el chunk de consumo, estimamos el uso y lo corregimos en la conciliación diaria con nuestro proveedor. Esa línea aparece en tu resumen de uso como estimated hasta que se liquida.

Function calling y uso de tools

Las tools siguen el esquema de siempre. Si un modelo genera una llamada que no encaja con tu esquema, la registramos: en la versión 1 no la corregimos sin decir nada, porque arreglar tu salida a escondidas es peor que un fallo visible.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Busca una factura por su número.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

resp = client.chat.completions.create(
    model="eu-standard", messages=messages, tools=tools
)

Salida estructurada con un JSON schema

Pasa un JSON schema y valida la respuesta por tu parte. Nuestro consejo: valida siempre, aunque el modelo suela portarse bien.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Extrae el nombre y el importe."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

Cabeceras de respuesta: coste, tier y enrutamiento

Cada respuesta te dice qué ha pasado. No es un extra para depurar, es lo importante: puedes comprobar por ti mismo que has recibido lo que has pagado.

Límites de uso y topes de gasto

Hay un límite por clave y por cuenta, más los topes que fijas tú. Estos últimos importan más de lo que parece: sin tope, una clave filtrada o un bucle infinito en tu propio código pueden vaciar un saldo en una noche.

• Peticiones por minuto, por clave y por cuenta.
• Tope diario y mensual en euros, configurable por clave.
• Cuentas nuevas: un máximo de 25 € al día durante las primeras 48 horas, sea cual sea el saldo.
• Si en una hora vemos más de diez veces tu media semanal, pausamos la clave automáticamente y te enviamos un email. Mejor una falsa alarma que una cartera vacía.
• Una petición solo empieza si tu saldo es de al menos 0,05 €.

Códigos de error y qué hacer

Las peticiones fallidas no te cuestan nada: si no ha llegado una respuesta utilizable, no se descuenta nada de tu saldo.

Uso razonable y política de uso

Rechazamos dar instrucciones sobre armas, malware y fraude, y generar material que haga daño a menores. Esas negativas son definitivas: nunca reenviamos una petición así a otro modelo para sacarle una respuesta de todos modos.

Otra cosa es que un modelo se niegue a responder una pregunta legítima sobre política, historia o un tema socialmente delicado: eso lo tratamos como un defecto y la enviamos a un modelo sin ese punto ciego. Lo ves en la cabecera X-EU-Routed: censorship.

Uno de nuestros modelos tiene una licencia con su propia política de uso. Esa política se aplica en su totalidad: desviar la petición no sirve para saltarse los términos de una licencia.

¿No sabes si tu caso de uso encaja? Escribe a hello@europeanailab.eu. Una respuesta por adelantado nos sale más barata a los dos que una clave bloqueada después.

Preguntas frecuentes

Las preguntas que nos llegan por email antes de que nadie cree una clave: con qué es compatible la API, cuánto cuesta una petición y dónde se ejecuta.

Migrar una integración existente son tres líneas: la clave, la base URL y el nombre de un tier. El cambio completo, y lo que no se puede portar, está en cambiar en tres líneas. ¿Te queda alguna duda? Las tarifas de cada tier están en la página de precios, el modelo y la licencia de cada tier en transparencia de la IA, y lo que pasa durante una caída en la página de estado. Dos lecturas más largas: cuánto cuesta una API de IA por token y adónde van de verdad tus prompts.