Authentification et clés

Chaque appel de l’API se fait avec une clé sk-moon-…. La clé appartient à un workspace : les requêtes sont débitées de son porte-monnaie et suivent ses plafonds et, dans une organisation gérée, ses règles.

Envoyer la clé#Lien vers la section Envoyer la clé

Mettez la clé dans l’en-tête Authorization, après Bearer. L’en-tête x-api-key est aussi accepté.

curl https://api.realmoon.ai/v1/models \
  -H "Authorization: Bearer $MOONAI_API_KEY"

# Équivalent
curl https://api.realmoon.ai/v1/models \
  -H "x-api-key: $MOONAI_API_KEY"

import os
from openai import OpenAI

# Le SDK envoie la clé dans l'en-tête Authorization.
client = OpenAI(
    base_url="https://api.realmoon.ai/v1",
    api_key=os.environ["MOONAI_API_KEY"],
)
print([m.id for m in client.models.list()])

import OpenAI from 'openai';

// Le SDK envoie la clé dans l'en-tête Authorization.
const client = new OpenAI({
  baseURL: 'https://api.realmoon.ai/v1',
  apiKey: process.env.MOONAI_API_KEY,
});
const models = await client.models.list();
console.log(models.data.map((m) => m.id));

Une requête sans clé, ou avec une clé inconnue, révoquée ou expirée, reçoit 401 invalid_api_key. Les autres refus liés à la clé (adresse non autorisée, portée, débit) sont décrits dans Erreurs.

Qui gère les clés#Lien vers la section Qui gère les clés

Les clés se gèrent dans le portail, onglet « Clés API » (ouvrir). Seuls le propriétaire et les admins du workspace y ont accès. Aucun point d’accès de l’API, appelé avec une clé sk-moon-…, ne crée ni ne révoque de clé.

Une clé appartient au workspace, pas à la personne qui l’a créée. Elle cesse de fonctionner :

• quand elle est révoquée ou remplacée, ou quand elle expire ;
• quand le workspace est supprimé ;
• quand le compte du propriétaire du workspace est suspendu (dans la minute).

À chaque création de clé, un e-mail de sécurité est envoyé au propriétaire du workspace et au contact de facturation.

Créer une clé#Lien vers la section Créer une clé

1. Dans « Clés API », sous « Créer une clé API », saisissez un « Nom » (128 caractères au plus), par exemple « backend de production ».
2. Ouvrez « Options avancées » si vous voulez limiter la clé (tableau ci-dessous).
3. Cliquez sur « Créer une clé ».
4. Dans la fenêtre « Enregistrez votre clé API », copiez la clé, puis cliquez sur « J’ai enregistré ma clé ». Si vous fermez la fenêtre sans copier, Moon AI demande « Fermer sans copier votre clé ? » : la clé ne sera plus jamais affichée.

Le plafond et la liste d’IP se fixent à la création. Pour les changer, créez une nouvelle clé avec les bons réglages, mettez à jour vos applications, puis révoquez l’ancienne.

La liste des clés#Lien vers la section La liste des clés

Sous « Vos clés », chaque ligne montre :

• le début et la fin de la clé (sk-moon-...a1b2), pour la reconnaître ;
• « Créée le », « Expire le » et les badges « Expire bientôt » ou « Clé expirée » ;
• « Dernière utilisation » et le nombre de « Requêtes » (mis à jour au plus une fois par minute) ;
• le plafond de dépense et sa période, et « Moon Blur désactivé » le cas échéant.

Régler une clé#Lien vers la section Régler une clé

Le bouton « Réglages de la clé » d’une ligne ouvre :

• « Nom de la clé » et « Enregistrer le nom » ;
• l’interrupteur « Moon Blur », activé par défaut.

Moon Blur masque les données personnelles détectées (e-mails, numéros de téléphone, coordonnées bancaires, numéros d’identité) avant que la requête n’arrive chez le fournisseur du modèle, et les remet dans la réponse. Ne le désactivez que si votre application a besoin de ces données elles-mêmes, par exemple pour les extraire d’un document. Moon AI demande confirmation (« Désactiver Moon Blur pour cette clé ? ») et note le changement dans le journal d’audit du workspace. Voir Confidentialité.

Remplacer une clé#Lien vers la section Remplacer une clé

Le bouton « Remplacer la clé » crée une nouvelle clé avec les mêmes réglages et la même durée de validité. L’ancienne cesse de fonctionner immédiatement : mettez à jour vos applications avec la nouvelle, affichée une seule fois. Pour une clé expirée, le bouton s’appelle « Renouveler la clé » et fait la même chose.

Pour remplacer une clé sans interruption, créez plutôt une seconde clé, déployez-la, puis révoquez la première.

Révoquer une clé#Lien vers la section Révoquer une clé

Le bouton « Révoquer la clé » arrête la clé immédiatement pour toutes les applications qui l’utilisent. L’action est irréversible.

Portée de la clé#Lien vers la section Portée de la clé

Une clé porte des portées (scopes). Toutes les clés créées dans le portail ont la portée inference, exigée par tous les points d’accès de l’API, y compris /v1/models et /v1/credits. Une clé sans elle reçoit 403 missing_scope.

Bonnes pratiques#Lien vers la section Bonnes pratiques

• Une clé par application et par environnement : vous pouvez en révoquer une sans arrêter les autres.
• La clé reste côté serveur : jamais dans le code d’une page web ni d’une application mobile distribuée.
• Lisez la clé dans une variable d’environnement ou un gestionnaire de secrets, jamais en dur dans le code.
• Pour un serveur à adresse fixe, ajoutez une liste d’IP. Pour borner un risque, ajoutez un plafond de dépense à la clé et des plafonds au workspace (onglet « Limites »).
• Fixez une expiration aux clés temporaires (tests, prestataires).

En-têtes#Lien vers la section En-têtes

En-têtes de requête#Lien vers la section En-têtes de requête

En-têtes de réponse#Lien vers la section En-têtes de réponse

Pour lire les en-têtes avec un SDK :

curl -i https://api.realmoon.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-haiku-4.5", "messages": [{"role": "user", "content": "Bonjour"}]}'

raw = client.chat.completions.with_raw_response.create(
    model="anthropic/claude-haiku-4.5",
    messages=[{"role": "user", "content": "Bonjour"}],
)
print(raw.headers.get("x-moon-request-id"), raw.headers.get("x-moon-blur"))
completion = raw.parse()

const { data: completion, response } = await client.chat.completions
  .create({
    model: 'anthropic/claude-haiku-4.5',
    messages: [{ role: 'user', content: 'Bonjour' }],
  })
  .withResponse();
console.log(response.headers.get('x-moon-request-id'), response.headers.get('x-moon-blur'));