Connexion et utilisation | Documentation des API

Lorsqu'un appel échoue ou qu'une conversation est interrompue, vérifiez d'abord trois points avec une requête minimale : authentification, chemin de l'endpoint et disponibilité du modèle.

Impossible de se connecter à la plateforme ?

Vérifiez :

Que la clé API est correctement configurée, sans espace ni saut de ligne superflu.
Que l'URL de base est correcte et ne contient pas de chemins dupliqués.
Que le chemin de l'endpoint correspond au protocole du client, par exemple le chemin compatible OpenAI pour les clients OpenAI.
Que le réseau local, proxy d'entreprise, pare-feu, DNS ou inspection HTTPS ne bloque pas les requêtes.
Que la clé API n'a pas expiré, n'a pas été supprimée et n'appartient pas à un compte restreint.

Pour les appels compatibles OpenAI, testez une requête minimale sans streaming :

bash

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Si cette requête échoue, le problème concerne généralement le réseau, l'authentification, la configuration des chemins, les permissions du modèle ou l'état du compte.

Un modèle est sélectionné mais ne répond pas ou renvoie une erreur ?

Causes courantes :

L'ID du modèle est incorrect ou ne correspond pas à la liste de la plateforme.
Le modèle choisi est temporairement indisponible ou non autorisé pour la clé API.
Le format de la requête est invalide : noms de champs, imbrication ou types incorrects, par exemple.
Le solde du compte est insuffisant, le contexte ou la sortie est trop long, ou le délai du service a été dépassé.
Le client tiers ne traite pas correctement le streaming ou les réponses d'erreur.

Copiez l'ID exact depuis la console ou la liste des modèles, testez un corps minimal, puis réintroduisez progressivement le contexte et les paramètres.

Que faire en cas d'erreur ou de déconnexion du chat ?

Identifiez le moment de l'échec :

Avant le début de la requête : vérifiez l'authentification, le chemin, le modèle et les paramètres.
Pendant le streaming : vérifiez le délai du client, la chaîne de proxys et l'analyse SSE.
Avec un contexte ou une sortie long : vérifiez la taille de la requête, les limites de sortie et le délai du service.

Traitement recommandé :

Lisez les champs précis de l'erreur.
Désactivez temporairement le streaming pour distinguer une défaillance du modèle d'une erreur d'analyse du flux.
Ajoutez des nouvelles tentatives avec délai progressif pour 429, les instabilités réseau et certaines erreurs 5xx.
Incluez le contexte requis lors des nouvelles tentatives, sans supposer que le serveur conserve l'état de conversation.
Consignez X-Request-ID si le problème persiste.