Authentification
Chaque appel qui fait tourner un modèle porte une clé API — sk-eva-… — en jeton Bearer. ChatGPT et Claude passent plutôt par un connecteur OAuth 2.1, avec trois droits que vous approuvez.
BientôtOuverture prochaine : ce qui suit décrit le service tel qu'il fonctionnera.
Les clés API
Les appels à /chat/completions, /embeddings et /images portent une clé API en jeton Bearer. Les clés commencent par sk-eva-. Vous créez vos clés dans votre compte Evanesca, une fois le service ouvert ; la clé complète ne s'affiche qu'une fois, à sa création, puis seulement ses premiers caractères. Créez une clé par application ou par environnement : en révoquer une n'arrête rien d'autre.
Authorization: Bearer $EVANESCA_API_KEYGardez les clés côté serveur — dans une variable d'environnement (les exemples lisent EVANESCA_API_KEY) ou un gestionnaire de secrets —, jamais dans du code front-end ni dans un dépôt public. Si une clé fuit, révoquez-la dans votre compte : elle cesse de fonctionner aussitôt.
Quels appels demandent une clé
| Endpoint | À quoi il sert | Clé |
|---|---|---|
POST/chat/completions | Fait répondre un modèle de chat ; streaming possible. | Requise |
POST/messages | Les mêmes modèles de chat au format Messages d'Anthropic ; streaming possible. | Requise |
POST/messages/count_tokens | Estime, gratuitement, les tokens d'entrée d'une requête Messages. | Requise |
GET/models | Liste le catalogue : modèles de chat, d'embedding et d'image. | Aucune |
GET/models/{model} | Renvoie un seul modèle — ce qu'appelle models.retrieve() dans les SDK OpenAI. | Aucune |
POST/embeddings | Transforme du texte en vecteurs. | Requise |
POST/images/generations | Génère des images à partir d'un texte. | Requise |
POST/images/edits | Génère des portraits à partir de 1 à 4 photos de visage. | Requise |
Le catalogue répond sans clé — même avec une clé mal recopiée : un 200 sur GET /models ne prouve donc pas que votre clé marche. Le vrai test est un appel de chat (premier appel).
Une clé refusée
Pas de clé, une clé malformée ou une clé révoquée : l'appel reçoit 401 invalid_api_key. Une clé valide sur un compte dont le crédit est à zéro reçoit 402 insufficient_credit (toutes les erreurs).
Le connecteur OAuth 2.1
ChatGPT et Claude ne prennent pas de clé dans un en-tête : ils se connectent au serveur MCP en OAuth 2.1. Vous vous connectez à votre compte Evanesca et vous approuvez ce que le connecteur pourra faire ; aucune clé n'est copiée nulle part. Une clé API porte tous les droits ; un connecteur ne porte que ceux que vous avez approuvés.
| Droit | Ce qu'il permet | Outils |
|---|---|---|
inference | Faire tourner des modèles en votre nom — chat completions et embeddings, facturés sur votre crédit comme tout appel à l'API. | chat_completion et create_embedding |
web | Chercher et lire des pages web, facturé à l'appel. | web_search et web_fetch |
account:read | Voir le nom du compte, son adresse e-mail et son crédit. | check_balance et get_profile |
Un jeton d'accès est valable 1 heure ; le client le renouvelle avec un jeton de rafraîchissement valable 60 jours, remplacé à chaque usage. Les jetons sont opaques, Evanesca n'en garde que l'empreinte, et ils ne valent que pour l'endpoint MCP, pas pour l'API REST. La connexion apparaît parmi vos clés API sous le nom « <client> (OAuth) » : révoquez-la là pour la couper.
Pour les développeurs de clients : PKCE en S256, le paramètre resource (RFC 8707), découverte à https://evanesca.app/.well-known/oauth-protected-resource — le détail est sur la page MCP, d'après les guides des connecteurs de Claude et d'OpenAI lus le 13 oct. 2026.