Documentation / développeurs

Une API. À vous de jouer.

Authentifiez vos requêtes, trouvez vos modèles et intégrez votre première conversation. Les exemples restent côté serveur.

Utilisez une clé API CONSTELLO et un modèle accessible à votre compte. Les requêtes exécutées consomment vos crédits selon votre utilisation.

Démarrage rapide

Créez votre compte sur gateway.constello.ch, rechargez votre solde si nécessaire, puis créez une clé dans « Clés API ». Choisissez un identifiant dans « Modèles IA » ou via GET /v1/models. Définissez ensuite ces variables dans votre terminal.

BASE URLhttps://gateway.constello.ch/v1
Shell 
export GATEWAY_URL="https://gateway.constello.ch"
export GATEWAY_API_KEY="YOUR_GATEWAY_TOKEN"
export GATEWAY_MODEL="YOUR_MODEL_ID"

Syntaxe Bash / zsh. Remplacez les valeurs fictives. Les exemples Python et JavaScript utilisent ces mêmes variables d’environnement.

Dans un SDK compatible OpenAI, définissez base_url ou baseURL sur https://gateway.constello.ch/v1. Dans les exemples ci-dessous, GATEWAY_URL désigne la racine sans /v1 : les chemins ajoutent déjà ce préfixe.

Authentification

Envoyez votre clé API CONSTELLO dans l’en-tête Authorization. Utilisez une clé API, jamais votre mot de passe de connexion.

Authorization: Bearer YOUR_GATEWAY_TOKEN

Conservez la clé dans les variables d’environnement de votre serveur ou de votre outil local. Ne l’intégrez pas au JavaScript public ni à un dépôt Git. Appelez exclusivement l’adresse HTTPS de la Gateway.

Modèles

GET/v1/models

Listez les modèles accessibles avec votre clé. Copiez exactement un identifiant renvoyé dans le champ model de votre requête.

cURL 
curl "$GATEWAY_URL/v1/models" \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

Conversations

POST/v1/chat/completions

Envoyez un tableau de messages à un modèle configuré. Ces exemples demandent une réponse complète, sans streaming. Python utilise sa bibliothèque standard ; JavaScript s’exécute avec Node.js 18 ou ultérieur.

Champ Type Description
model string Requis. Identifiant exact d’un modèle configuré.
messages array Requis. Messages contenant role et content.
stream boolean Optionnel. true pour recevoir la réponse progressivement.

Streaming

Ajoutez stream: true et utilisez un client capable de lire les événements SSE. Avec cURL, -N désactive la mise en tampon de la sortie.

cURL / SSE 
curl -N "$GATEWAY_URL/v1/chat/completions" \
  -H "Authorization: Bearer $GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"stream":true}'

Remplacez YOUR_MODEL_ID par un identifiant accessible à votre compte. Gérez les interruptions et les erreurs du flux. Le streaming dépend du modèle choisi.

Résoudre une erreur

Consultez le statut HTTP et le message retourné, puis les journaux de la Gateway. Ne partagez pas vos en-têtes d’authentification dans un rapport d’erreur.

Accès refusé

Vérifiez le jeton, son état, sa date d’expiration et ses restrictions.

Quota ou limite atteint

Vérifiez votre solde, le quota de la clé et les limites de requêtes. En cas de limitation temporaire, espacez les appels.

Modèle indisponible

Vérifiez l’identifiant du modèle et les restrictions de votre clé. Consultez l’état des services puis contactez l’assistance si le problème persiste ; ne transmettez jamais votre clé.

Ouvrir la console