Remettez une requête sur la bonne voie.

Consultez le statut du service, puis séparez les problèmes d'accès au compte, d'authentification API, de découverte de modèles, d'inférence et de paiement. Un modèle apparaissant dans le catalogue n'établit pas la disponibilité en direct : GET /v1/models répertorie les déploiements connectés.

Un 503 service_unavailable signifie que le service requis ne peut pas accepter la requête. Consultez le statut du service et la référence API avant de réessayer ; des requêtes répétées ne peuvent pas activer un service indisponible. Pour un GPU dédié, attendez la confirmation de l'approvisionnement. Pour les paiements, suivez les instructions de la commande et l'état de vérification enregistré ; actualiser une commande n'ajoute pas de crédit.

Enregistrez le statut HTTP ainsi que le code et le message de l’erreur. Vérifiez l’URL de base de l’API configurée, l’identifiant exact du modèle et la version du client avant de modifier la logique applicative.

• 401 : vérifiez l’en-tête Bearer et si la clé a été révoquée. Ne laissez pas la clé complète dans les journaux.
• 403 : choisissez un modèle autorisé par la liste d’autorisation de la clé.
• 400 ou 413 : vérifiez le JSON, les champs obligatoires, la limite de sortie et le budget de contexte combiné entrée/sortie.
• 402 : vérifiez si le compte dispose d’un rechargement confirmé éligible d’au moins USD 100, puis vérifiez le crédit disponible et le budget de la clé sélectionnée ; les comptes éligibles n’ont pas besoin de maintenir un solde de USD 100.
• 429 : suivez un en-tête Retry-After s’il est fourni, utilisez des nouvelles tentatives limitées et vérifiez les limites de service applicables ; il n’y a pas d’allocation quotidienne d’essai gratuit.
• 502 ou 503 : vérifiez la disponibilité et le message d’erreur avant une nouvelle tentative limitée.

Le guide des erreurs et les limites expliquent les voies de récupération. Une nouvelle requête peut créer un nouveau travail ; ne supposez pas que les nouvelles tentatives du client sont dédupliquées.

Un onglet de navigateur fermé, un délai d'attente ou un flux rompu ne prouvent pas que la génération s'est arrêtée. Enregistrez tout identifiant de réponse et le message final contenant les données d'utilisation si reçu. Le message final contenant les données d'utilisation peut arriver après le finish_reason du choix ; un fragment reçu sur le réseau n'est pas nécessairement un événement complet.

Un 409 pending_reconciliation, ou une erreur en amont après l'envoi, peut laisser le crédit réservé jusqu'à ce que les données d'utilisation confirmées soit disponible. Évitez d'envoyer des requêtes en double pour lever la retenue. Comparez l'heure UTC, le modèle et le nom de la clé avec l'utilisation de la console, et conservez les détails de la requête pour la réconciliation. Les délais de libération du crédit réservé ne sont pas garantis.

Pour un problème de paiement, enregistrez la référence de la commande, l'actif, le réseau, le montant et l'état visible. N'envoyez jamais un autre paiement simplement parce que le premier est en attente. Les retraits vers un portefeuille sont actuellement indisponibles. Annuler une commande GPU payée avant l'activation retourne son paiement au solde du compte WeightsAPI ; cela ne transfère pas de fonds vers un portefeuille.

Un rapport utile inclut l’opération, l’horodatage UTC, le chemin de l’endpoint, l’identifiant du modèle, le SDK ou l’intégration et sa version, le paramètre de streaming, la limite de jetons de sortie, le statut/l’erreur, le résultat attendu et le résultat réel. Incluez une référence de réponse ou de transaction uniquement si elle est disponible ; la passerelle n’expose actuellement pas d’identifiant de support sur chaque erreur.

Ajoutez le plus petit exemple synthétique qui reproduit le problème. Remplacez les conversations réelles, les dossiers clients et les documents privés par un texte inventé. Incluez le nombre de nouvelles tentatives pertinent et indiquez si le problème se répète d’une requête à l’autre. Les captures d’écran doivent montrer l’erreur et le contexte après avoir supprimé les informations d’identification, les soldes ou les identifiants que vous ne souhaitez pas partager.

Pour une commande de GPU dédié, incluez la référence de la commande, la configuration et le statut visible de paiement ou de provisionnement. Une commande en attente n'est pas une machine active.

N’incluez jamais un secret API, un en-tête Authorization, un cookie de session, une clé privée de portefeuille, une phrase de récupération ou un fichier d’environnement complet. Un nom de clé ou un préfixe délibérément raccourci suffit à distinguer les applications. Les références de transaction publiques peuvent encore relier une activité à un portefeuille ; ne partagez que ce dont l’enquête a besoin.

Si une clé a été exposée, créez une clé de remplacement, mettez à jour l’application et révoquez l’ancienne clé. La révocation bloque les nouvelles admissions ; les requêtes précédemment admises se règlent normalement. Consultez authentification pour la gestion des clés.

Copiez et examinez votre rapport, puis conservez-le avec la référence de la requête ou de la commande pertinente. La copie ne soumet pas de ticket. Les contacts de support officiels et les heures de service ne sont pas publiés ; utilisez uniquement un canal confirmé pour partager un rapport.

Les objectifs de réponse, les contacts d'escalade et les crédits de service n'ont pas été établis. Gardez les informations d'identification et le contenu sensible des clients hors de votre rapport.