Référence de l'API
Chaque opération de l'API compatible OpenAI d'Evanesca : ses paramètres, l'appel en cURL, Python, JavaScript et Go, ses réponses — et, pour chacune, où elle tourne et ce qu'elle coûte.
BientôtOuverture prochaine : ce qui suit décrit le service tel qu'il fonctionnera.
URL de base et clé
https://evanesca.app/api/v1Envoyez votre clé dans l'en-tête Authorization: Bearer ; les clés commencent par sk-eva-. Le catalogue se lit sans clé (authentification). Les SDK officiels d'OpenAI fonctionnent tels quels : donnez cette URL à base_url (baseURL en JavaScript) (premier appel).
Endpoints
| 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 |
Formats servis
Evanesca sert le format Chat Completions d'OpenAI et, sur les mêmes modèles, le format Messages d'Anthropic (POST /messages, pour Claude Code et les SDK d'Anthropic). Elle ne sert pas la Responses API plus récente d'OpenAI (/responses) : un outil réglé par défaut sur elle doit être repassé en chat completions — les intégrations disent où.
Erreurs
Les erreurs reviennent en JSON, au format d'OpenAI : un objet error avec un message lisible et un type stable (tous les statuts).
{
"error": {
"message": "Insufficient credit balance. Add credit to your account to continue.",
"type": "insufficient_credit"
}
}