Une ligne de code, et tu tournes dans l’Union européenne.

Démarrage rapide : ton premier appel API

Crée une clé dans ton tableau de bord, sous Paramètres, Clés API. Tu ne vois le secret qu’une seule fois : ensuite, nous ne gardons qu’un hash et le préfixe. Mets-la dans une variable d’environnement, jamais dans ton dépôt.

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": "Explique l’autoliquidation de la TVA."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Explique l’autoliquidation de la TVA."}],
)
print(resp.choices[0].message.content)

Niveaux de modèles et fenêtres de contexte

Dans le champ model, tu passes un niveau, pas un nom de modèle. Ton intégration continue ainsi de fonctionner quand nous remplaçons le modèle sous-jacent, et cela arrivera, parce que les modèles open-weight sont retirés et dépassés.

Si tu dépasses la fenêtre de contexte d’un niveau, tu reçois un 400 qui indique le maximum : nous ne tronquons jamais ton prompt en silence.

Réponses en streaming

Le streaming fonctionne comme tu t’y attends, avec une différence importante à connaître, parce qu’elle touche à ton argent.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Écris un résumé."}],
    stream=True,
    # Sans cela, pas d’objet usage et tu ne vois pas le coût.
    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:                      # dernier chunk
        print("\n", chunk.usage)

Si tu coupes un flux en cours de route, tu ne paies que ce qui a été généré jusque-là. Si la connexion interrompue empêche l’arrivée du chunk de consommation, nous estimons la consommation et la corrigeons lors du rapprochement quotidien avec notre fournisseur. Une telle ligne apparaît dans ton aperçu de consommation comme estimated jusqu’à sa régularisation.

Function calling et utilisation d’outils

Les tools suivent le schéma habituel. Si un modèle produit un appel d’outil qui ne correspond pas à ton schéma, nous le journalisons : en version 1, nous ne le corrigeons pas en silence, car réparer discrètement ta sortie est pire qu’un échec visible.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Recherche une facture par son numéro.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

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

Sortie structurée avec un schéma JSON

Passe un schéma JSON et valide la réponse de ton côté. Notre conseil : valide toujours, même quand le modèle se tient bien d’habitude.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Extrais le nom et le montant."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

En-têtes de réponse : coût, niveau et routage

Chaque réponse te dit ce qui s’est passé. Ce n’est pas un bonus de débogage, c’est tout l’intérêt : tu peux vérifier toi-même que tu as obtenu ce que tu as payé.

Limites de débit et plafonds de dépenses

Il y a une limite par clé et par compte, plus les plafonds que tu fixes toi-même. Ces derniers comptent plus qu’il n’y paraît : sans plafond, une clé qui fuite ou une boucle infinie dans ton propre code peut vider un solde en une nuit.

• Requêtes par minute, par clé et par compte.
• Plafond journalier et mensuel en euros, réglable par clé.
• Nouveaux comptes : 25 € par jour au maximum pendant les 48 premières heures, quel que soit le solde.
• Si nous voyons plus de dix fois ta moyenne hebdomadaire en une heure, nous mettons la clé en pause automatiquement et nous t’envoyons un e-mail. Mieux vaut une fausse alerte qu’un porte-monnaie vide.
• Une requête ne démarre que si ton solde atteint au moins 0,05 €.

Codes d’erreur et que faire

Une requête échouée ne te coûte rien : si aucune réponse exploitable n’est revenue, rien n’est débité de ton solde.

Usage raisonnable et politique d’utilisation

Nous refusons les instructions pour des armes, des logiciels malveillants et de la fraude, ainsi que les contenus qui portent atteinte aux enfants. Ces refus sont définitifs : nous ne transmettons jamais une telle requête à un autre modèle pour obtenir quand même une réponse.

Qu’un modèle refuse une question légitime sur la politique, l’histoire ou un sujet de société sensible, c’est autre chose : nous le traitons comme un défaut et envoyons la question à un modèle qui n’a pas cet angle mort. Tu le vois dans l’en-tête X-EU-Routed: censorship.

L’un de nos modèles est distribué sous une licence qui a sa propre politique d’utilisation. Cette politique s’applique entièrement : la redirection ne permet pas de contourner les conditions d’une licence.

Tu ne sais pas si ton cas d’usage est acceptable ? Écris à hello@europeanailab.eu. Une réponse en amont nous coûte moins cher à tous les deux qu’une clé bloquée après coup.

Questions fréquentes

Les questions qui arrivent par e-mail avant que quiconque crée une clé : avec quoi l’API est compatible, ce que coûte une requête et où elle tourne.

Migrer une intégration existante tient en trois lignes : la clé, la base URL et un nom de niveau. Le changement complet, et ce qui ne se transpose pas, se trouve dans changer de fournisseur en trois lignes. Encore une question ? Les tarifs par niveau sont sur la page Tarifs, le modèle et la licence derrière chaque niveau sur Transparence IA, et ce qui se passe pendant une panne sur la page Statut. Deux lectures plus longues : ce que coûte une API d’IA par token et où vont vraiment tes prompts.