Premier appel

Une clé, l'adresse de la Gateway et le SDK OpenAI : c'est tout ce qu'il faut. Ce guide vous mène jusqu'à la première réponse d'un modèle.

1. Créer une clé

1. Ouvrez la page « Gateway IA »Dans Supervise, menu de gauche.
2. Cliquez sur « Nouvelle clé »Donnez-lui un nom qui dit à quoi elle sert : un nom par script ou par usage (relance-clients, chatbot-support…).
3. Copiez la clé tout de suiteElle commence par sv_gw_ et n'est affichée qu'une seule fois. Supervise n'en garde qu'une empreinte : si vous la perdez, révoquez-la et créez-en une autre.

2. Copier l'adresse de la Gateway

Elle est en haut de la même page, sous « Adresse de la gateway », avec un bouton Copier. Elle se termine par /v1 : c'est le base_url du client OpenAI.

3. Ranger la clé et l'adresse hors du code

Mettez-les dans des variables d'environnement, jamais en clair dans le code ni dans un dépôt Git :

$ export GATEWAY_BASE_URL="https://api.wesupervise.ai/v1"   # l'adresse copiée
$ export GATEWAY_API_KEY="sv_gw_…"                       # votre clé

4. Appeler un modèle

$ pip install openai

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["GATEWAY_BASE_URL"],
    api_key=os.environ["GATEWAY_API_KEY"],
)

r = client.chat.completions.create(
    model="anthropic/claude-haiku-4-5-20251001",
    messages=[{"role": "user", "content": "Bonjour"}],
    metadata={"flag": "mon-script"},
)
print(r.choices[0].message.content)

$ npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: process.env.GATEWAY_BASE_URL,
  apiKey: process.env.GATEWAY_API_KEY,
});

const r = await client.chat.completions.create({
  model: "anthropic/claude-haiku-4-5-20251001",
  messages: [{ role: "user", content: "Bonjour" }],
  metadata: { flag: "mon-script" },
});
console.log(r.choices[0].message.content);

$ curl -s "$GATEWAY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-haiku-4-5-20251001",
       "messages": [{"role": "user", "content": "Bonjour"}],
       "metadata": {"flag": "mon-script"}}'

Le flag est facultatif : il étiquette l'appel pour le retrouver ensuite dans Supervise. Voir Flags et modèle de secours.

5. Retrouver l'appel dans Supervise

Sur la page « Gateway IA », la ligne de votre clé indique le dernier usage, le nombre d'appels et le coût du mois. Voir les appels ouvre l'onglet « Activité », où chaque appel apparaît avec son modèle, ses tokens, son coût et son flag. Voir Suivre la consommation.

Voir les modèles disponibles

La liste dépend de ce que votre organisation a ouvert :

for m in client.models.list():
    print(m.id)

for await (const m of client.models.list()) console.log(m.id);

$ curl -s "$GATEWAY_BASE_URL/models" -H "Authorization: Bearer $GATEWAY_API_KEY"

Les identifiants ont la forme fournisseur/modèle, par exemple anthropic/claude-sonnet-4-5. Un modèle absent de la liste répond 404.