Référence de l’API

URL de base

Chaque requête va vers :

Authentification

Créez une clé sur la page clés API, puis envoyez-la comme jeton bearer dans l’en-tête Authorization. Seul un hash de votre clé est stocké — copiez-la à sa création, car GatifyAI ne pourra plus vous la montrer ensuite.

Démarrage rapide

Une requête minimale en curl, Python ou TypeScript :

curl https://gatifyai.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Restreindre une clé à des modèles spécifiques

Par défaut, une nouvelle clé peut utiliser n’importe quel modèle gratuit de GatifyAI, avec le même basculement automatique que le chat web si l’un d’eux est indisponible. Vous pouvez à la place restreindre une clé à un modèle précis ou à une courte liste — la clé n’utilisera alors que les modèles de cette liste, dans l’ordre indiqué, quel que soit le modèle demandé par une requête. Demander un modèle hors de cette liste renvoie une erreur 400 nommant les modèles réellement autorisés pour cette clé.

Discuter avec une persona

Passez model: "persona/<slug>" pour discuter avec une persona publiée dans la galerie communautaire — sa personnalité et ses modèles préférés sont utilisés automatiquement, toujours contraints par les modèles autorisés de votre clé si vous en avez défini. Retrouvez le slug d’une persona et un exemple prêt à l’emploi sur sa propre page, sous l’onglet API.

{
  "model": "persona/senior-engineer",
  "messages": [{"role": "user", "content": "Review my code."}]
}

Streaming vs. non-streaming

Définissez stream: true pour recevoir les tokens au fur et à mesure de leur génération, exactement comme le format de streaming OpenAI (Server-Sent Events, terminé par [DONE]). Omettez-le, ou mettez-le à false, pour attendre la réponse complète et recevoir une seule réponse JSON — c’est le comportement par défaut.

Erreurs

Les erreurs suivent le format d’erreur OpenAI : {"error": {"message": "...", "type": "..."}}. Un 401 signifie une clé manquante, invalide ou révoquée. Un 400 signifie que la requête elle-même est invalide — le plus souvent un modèle non reconnu, un slug de persona non publié/inconnu, ou un modèle hors de la liste autorisée de votre clé. Un 502 signifie qu’aucun modèle candidat n’a répondu.

{
  "error": {
    "message": "This API key may only use: llama-3.1-8b:free",
    "type": "invalid_request_error"
  }
}

Limites de fréquence

Les requêtes API comptent dans la même limite de fréquence de chat par compte que l’application web — il n’existe pas encore de quota séparé pour le trafic API.