Démarrage rapide

Objectif : obtenir une réponse du modèle via POST /v1/chat/completions en moins de cinq minutes.

Si vous n’avez pas encore d’accès, demandez une clé Albert API ici :

Demander un accès

Pour le workflow complet (validation admin, email, Playground, création de clés) : Créer un compte & accès.

Étape 1 — Obtenir un jeton

La méthode principale pour obtenir une clé est de la générer dans le Playground (interface web). Une alternative consiste à créer une clé via l’API (POST /v1/me/keys, voir Clés API).

1) Ouvrir la page « API keys » du Playground

Allez sur : Créer / gérer vos clés API (Playground)

Créer une clé — formulaire vide

2) Renseigner le nom et, si besoin, la date d’expiration

• Name : obligatoire (nom lisible pour vous retrouver dans la liste).
• Expires at : optionnel (date de fin de validité).

Créer une clé — nom et expiration

3) Copier et stocker la clé en lieu sûr

Après création, la clé est affichée une seule fois. Copiez-la immédiatement et conservez-la dans un gestionnaire de secrets (ou variable d’environnement), car vous ne pourrez pas la réafficher ensuite.

Clé créée — copie unique

4) Utiliser la clé dans votre code ou un outil compatible OpenAI

Exportez-la dans votre environnement, par exemple :

export ALBERT_API_KEY="votre_jeton"

Puis utilisez-la comme api_key / jeton Bearer dans un client OpenAI ou tout outil compatible (voir section Compatibilité OpenAI ci-dessous).

Étape 2 — Choisir un modèle

Listez les modèles disponibles :

curl

curl -sS "https://albert.api.etalab.gouv.fr/v1/models" \
  -H "Authorization: Bearer $ALBERT_API_KEY"

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://albert.api.etalab.gouv.fr/v1",
    api_key=os.environ["ALBERT_API_KEY"],
)

models = client.models.list().data
print([m.id for m in models])

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://albert.api.etalab.gouv.fr/v1",
  apiKey: process.env.ALBERT_API_KEY,
});

const models = await client.models.list();
console.log(models.data.map((m) => m.id));

Choisissez un modèle dont le champ type est text-generation (voir Types de modèles). Notez son id (par ex. Meta-Llama-3.1-8B-Instruct — l’offre exacte dépend de la plateforme).

Étape 3 — Envoyer une complétion de chat

curl

curl -sS "https://albert.api.etalab.gouv.fr/v1/chat/completions" \
  -H "Authorization: Bearer $ALBERT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "REMPLACER_PAR_ID_MODELE",
    "messages": [
      {"role": "system", "content": "Tu réponds en français, de façon concise."},
      {"role": "user", "content": "Explique ce qu’est une API compatible OpenAI en deux phrases."}
    ]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://albert.api.etalab.gouv.fr/v1",
    api_key=os.environ["ALBERT_API_KEY"],
)

r = client.chat.completions.create(
    model="REMPLACER_PAR_ID_MODELE",
    messages=[
        {"role": "system", "content": "Tu réponds en français, de façon concise."},
        {"role": "user", "content": "Explique ce qu’est une API compatible OpenAI en deux phrases."},
    ],
)
print(r.choices[0].message.content)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://albert.api.etalab.gouv.fr/v1",
  apiKey: process.env.ALBERT_API_KEY,
});

const r = await client.chat.completions.create({
  model: "REMPLACER_PAR_ID_MODELE",
  messages: [
    { role: "system", content: "Tu réponds en français, de façon concise." },
    { role: "user", content: "Explique ce qu’est une API compatible OpenAI en deux phrases." }
  ],
});

console.log(r.choices[0].message.content);

Compatibilité OpenAI

Albert API est compatible OpenAI sur les endpoints courants : en conservant votre code basé sur le SDK ou sur des appels HTTP OpenAI, vous changez en principe uniquement la base URL (ici https://albert.api.etalab.gouv.fr/v1) et la clé (jeton Albert).

Pour aller plus loin : Chat completions, page de l’endpoint Chat.