aisplice

Référence API

Avant la mise en production

Utilisez cette checklist avant d'ouvrir le trafic de production. Elle réunit la sécurité des clés, les nouvelles tentatives, la durabilité des tâches asynchrones, l'observabilité et la facturation en un seul ensemble de critères de mise en production.

#Checklist de production

Sécurité

  • Conservez les clés API sur des serveurs de confiance ; ne livrez jamais de clé permanente dans un navigateur ou un binaire mobile.
  • Utilisez une clé à portée limitée par projet et configurez les limites de modèles, d'IP, de RPM, de RPD et de quota.
  • Effectuez la rotation des clés sans modifier le code d'intégration des modèles.

Fiabilité

  • Définissez des délais d'expiration de connexion et de réponse pour chaque requête.
  • Respectez Retry-After et utilisez un backoff exponentiel avec jitter.
  • Utilisez Idempotency-Key pour les soumissions asynchrones facturables et enregistrez task_id.

Observabilité

  • Journalisez l'ID de requête, le modèle, l'endpoint, la latence, le statut HTTP et task_id.
  • Gardez le contenu des prompts hors des journaux, sauf si le débogage est explicitement activé.
  • Reliez les échecs visibles par les clients à la ligne correspondante du journal des requêtes.

Maîtrise des coûts

  • Lisez les prix et les options prises en charge dans les métadonnées des modèles en direct.
  • Définissez des plafonds de quota par projet et déclenchez une alerte avant que le portefeuille ne soit épuisé.
  • Faites le rapprochement avec la consommation finale à six décimales du journal des requêtes.

#Critères de mise en production

  1. 1

    Tester la requête minimale

    Exécutez exactement le même modèle et le même endpoint dans le Workbench, puis copiez la requête générée.

  2. 2

    Tester les cas d'échec

    Vérifiez la gestion des 401, 402, 429, des délais d'expiration, des médias invalides et des échecs définitifs de tâche.

  3. 3

    Vérifier la facturation

    Rapprochez une requête réussie de sa consommation à six décimales et de son ID de requête.

  4. 4

    Activer la surveillance

    Déclenchez des alertes sur le taux d'erreur, la latence, les tâches bloquées, les échecs de webhook et le solde faible.

#Raccourcis opérationnels

Gérer les clésConsulter l'utilisation et le journal des requêtesConsulter le portefeuilleConsulter l'état de la plateforme

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.

PrécédentAnciennes API et compatibilitéSuivantChat Completions