Get API

GET API · Intégrations pour développeurs

Comment un service Python peut appeler plusieurs modèles de manière fiable

Un service Python peut faire pointer un client compatible vers https://relay-api.getapi.pro/v1, lire sa clé API depuis une variable d’environnement protégée et utiliser un nom de modèle du catalogue dans chaque requête. Le code de production doit également définir des délais de connexion et de lecture, limiter les nouvelles tentatives, distinguer les échecs qui peuvent être retentés, valider la structure des réponses et exclure des journaux les identifiants d’accès complets et les prompts sensibles.

Séparez la configuration de la logique métier

Lisez l’URL de base, l’identifiant d’accès et le modèle par défaut depuis la configuration au lieu de les coder en dur dans les modules de l’application. Cela permet de changer de modèle sans réécrire le comportement métier et évite de placer des secrets dans le dépôt de code source.

  • Lisez les identifiants d’accès depuis l’environnement ou un gestionnaire de secrets
  • Validez la configuration requise au démarrage
  • Centralisez les noms de modèles autorisés

Fixez une limite aux tentatives de récupération réseau

Les nouvelles tentatives illimitées multiplient à la fois le coût et la latence. Ne retentez que les échecs transitoires confirmés, avec un nombre maximal de tentatives et un délai progressif, et imposez une échéance globale à la requête. Les erreurs d’authentification et d’entrée invalide doivent être signalées immédiatement.

  • Définissez séparément les délais de connexion et de lecture
  • Limitez le nombre de tentatives et le temps total écoulé
  • Consignez les catégories d’erreur sans les prompts complets

Traitez la sortie du modèle comme une entrée non fiable

Demander du JSON ne garantit pas une structure valide. Appliquez une validation de schéma, des limites de longueur et des contraintes métier avant que la sortie n’atteigne une base de données ou ne déclenche une action automatisée.

  • Prévoyez un état d’erreur sûr en cas d’échec de l’analyse
  • Limitez les valeurs d’énumération et les plages numériques
  • Exigez une confirmation pour les actions à risque élevé

Questions fréquentes

Quelle valeur de base_url un client Python doit-il utiliser ?

Utilisez https://relay-api.getapi.pro/v1 ; une méthode de chat compatible appelle ensuite /chat/completions sous cette URL.

Peut-on écrire la clé API dans un fichier Python ?

Il ne faut pas le faire. Utilisez une variable d’environnement ou un gestionnaire de secrets et excluez les fichiers de secrets locaux du contrôle de version.

Quelles erreurs doivent déclencher une nouvelle tentative automatique ?

Ne retentez que les échecs transitoires confirmés liés au réseau, aux limites de débit ou au service. Corrigez les erreurs d’authentification et d’entrée avant de réessayer.

Contact commercial: business@honeykid.cn