API et intégrations
Connectez une application avec l’API d’inférence documentée ou l’API d’entraînement de modèles, des identifiants aux droits limités et les références actuelles sur l’utilisation et les API.
- Choisir le produit APIDistinguez les requêtes d’inférence des parcours d’entraînement de modèles.
- Lire son contratConsultez la documentation API et la référence OpenAPI correspondantes.
- Créer une clé aux droits limitésGénérez et stockez une clé API client en toute sécurité.
- Intégrer et vérifierEnvoyez une requête documentée et examinez la réponse.
- Surveiller et renouvelerConsultez l’utilisation et révoquez ou renouvelez les clés au besoin.
Choisir le bon parcours API
L’API d’inférence sert aux requêtes d’inférence de modèles. L’API d’entraînement de modèles décrit un parcours distinct comprenant devis, tâches, sessions et artefacts. Ne supposez pas qu’un point de terminaison d’inférence lance un entraînement ni qu’une opération d’entraînement est disponible dans le contrat d’inférence. Lisez la documentation du produit visé et vérifiez que le modèle ou la capacité d’entraînement y figure. Utilisez les formats de requête et de réponse publiés au lieu de déduire les noms de méthodes à partir d’un SDK tiers connu.
- Déterminez si l’application a besoin d’inférence ou d’entraînement de modèles.
- Ouvrez la documentation et la référence API du produit correspondant.
- Vérifiez que la capacité et le modèle souhaités sont documentés.
Créer et protéger une clé API
Créez une clé API client depuis la page authentifiée des clés API et, si l’interface propose des choix de portée, ne sélectionnez que ceux nécessaires à l’intégration. Le secret n’est affiché qu’une seule fois : placez-le directement dans un gestionnaire de secrets approuvé. Ne l’enregistrez pas dans le dépôt de code, dans les journaux ou dans du code exécuté dans le navigateur. Dans la mesure du possible, étiquetez les identifiants par application et environnement. Utilisez des identifiants distincts pour le développement et la production afin de pouvoir en révoquer un sans interrompre les autres intégrations.
- Ouvrez Clés API dans l’espace client authentifié.
- Créez une clé avec la portée minimale requise.
- Stockez le secret en lieu sûr, sans l’inclure dans le code source ni les journaux.
Mettre en œuvre le contrat documenté
Suivez le guide API correspondant pour l’authentification, le point de terminaison, les champs de requête, le traitement des réponses et les erreurs. Gardez les identifiants de service sur un serveur de confiance plutôt que dans du code client public. Validez les entrées avant l’envoi, traitez explicitement les réponses d’échec et évitez de journaliser les en-têtes d’autorisation ou les données sensibles des invites. Utilisez la référence OpenAPI pour consulter le contrat publié exploitable par machine. Ne supposez pas que les opérations de diffusion en continu, multimédias ou propres à un fournisseur sont prises en charge, sauf si la documentation actuelle les mentionne explicitement.
- Implémentez uniquement les opérations et champs décrits pour l’API choisie.
- Gardez les identifiants côté serveur et masquez-les dans les diagnostics.
- Gérez les erreurs documentées et conservez les identifiants de requête lorsqu’ils sont fournis.
Surveiller l’utilisation et gérer les identifiants
Après l’intégration, consultez la page d’utilisation pour comprendre l’activité associée à votre compte et la comparer aux données de votre application. Examinez toute variation inattendue avant d’augmenter le trafic ou de créer d’autres identifiants. Si une clé a pu être exposée, renouvelez-la, mettez à jour le gestionnaire de secrets de l’application et vérifiez l’intégration avant de supprimer tout ancien identifiant restant. Révoquez les clés devenues inutiles. Les données d’utilisation facilitent le suivi opérationnel, mais ne garantissent ni les frais ni la capacité à venir.
- Comparez l’utilisation de la plateforme aux enregistrements de requêtes de votre application.
- Renouvelez tout identifiant exposé et vérifiez le remplacement.
- Révoquez les clés inutilisées et réexaminez régulièrement les accès.
Questions fréquentes
L’inférence et l’entraînement de modèles utilisent-ils la même API ?
Non. Ce sont des produits distincts avec des parcours documentés différents. Consultez la référence correspondant à votre besoin.
Où trouver le contrat API pris en charge ?
Consultez la documentation du produit et la référence OpenAPI associées à ce guide. Elles décrivent l’interface actuellement publiée.
Où stocker un secret API ?
Utilisez un gestionnaire de secrets sécurisé côté serveur. Ne l’ajoutez jamais à un dépôt, ne l’exposez pas dans du code navigateur et ne l’inscrivez pas dans des journaux.
Que faire si une clé est exposée ?
Renouvelez-la ou révoquez-la depuis Clés API, remplacez-la dans le gestionnaire de secrets de l’application et vérifiez l’utilisation récente pour repérer toute activité inattendue.