FAQ
Trouvez des réponses concises sur l’intégration API AGTCloud, l’authentification, les modèles et les erreurs courantes.
Cette page rassemble les questions courantes d’une première intégration AGTCloud. Les champs, capacités et codes propres à la plateforme restent définis par la documentation correspondante et les réponses réelles.
Suivez le Démarrage rapide pour vous connecter, créer une clé, choisir un modèle et envoyer une requête minimale. Testez d’abord OpenAI Chat compatible, puis ajoutez le streaming, les outils ou les entrées multimodales après validation du parcours de base.
Dans API Keys, créez, désactivez ou supprimez vos jetons. Utilisez des clés distinctes selon l’environnement et désactivez ou supprimez rapidement celles inutilisées ou potentiellement compromises.
La Base URL recommandée est https://api.agtcloud.cn/v1. Configurez-la comme base_url ou baseURL dans le SDK OpenAI. Les API compatibles utilisent généralement Authorization: Bearer your-api-key ; les autres protocoles suivent les Headers de leur référence. Consultez Clé API, Base URL et authentification.
Ce n’est pas recommandé. Conservez les clés de longue durée sur un serveur fiable, dans ses variables d’environnement ou dans un service de secrets. Le navigateur et l’application mobile doivent appeler votre backend, qui appelle AGTCloud, afin d’éviter l’extraction et l’abus des clés.
La Base URL contient souvent déjà /v1, ajouté une seconde fois par le code. Utilisez https://api.agtcloud.cn/v1 comme Base URL du SDK et laissez-le ajouter les endpoints tels que /chat/completions. Vérifiez l’URL finale complète pour le diagnostic.
Consultez les modèles et leurs identifiants dans le Catalogue de modèles. Leur visibilité dépend de la configuration et des autorisations ; copiez l’identifiant actuellement affiché et vérifiez le résultat réel de l’appel.
Si aucune sémantique native particulière n’est à conserver, commencez par OpenAI Chat Completions, dont les SDK et intégrations sont courants. Pour une application Anthropic, Gemini ou Responses existante, conservez d’abord le SDK et les messages, puis vérifiez l’adaptation du modèle.
Pour 401, vérifiez les Headers d’authentification et la clé ; pour 403, les droits du compte, de la clé et du modèle ; pour 404, la Base URL, l’endpoint et les identifiants. Corrigez la cause au lieu de réessayer indéfiniment. Consultez Erreurs et dépannage.
Recherchez x-request-id, request-id ou x-oneapi-request-id dans les Headers et conservez la valeur présente. Le corps de l’erreur peut aussi contenir le Request ID. Sinon, notez l’heure, la Method, le Path, le modèle et le statut HTTP. Consultez les exemples Request ID.
Désactivez ou supprimez immédiatement la clé dans API Keys, créez-en une nouvelle et mettez les services à jour. Recherchez les copies dans les dépôts, journaux, captures et conversations. Si elle a été déposée dans Git, traitez aussi l’historique selon la procédure de sécurité de l’équipe.
Préparez l’heure et le fuseau, la Method, le Path, le modèle, le statut HTTP, l’erreur expurgée, les versions du SDK et du runtime, ainsi qu’une reproduction minimale. Ajoutez le Request ID s’il existe. N’envoyez pas de clé complète, de Headers d’authentification, de Cookie, de prompt client ni de fichier privé.
Vous n’avez pas trouvé de réponse ?
Effectuez les vérifications de base dans Erreurs et dépannage, puis préparez un diagnostic expurgé selon Request ID. N’envoyez pas de clé complète, de Headers d’authentification, de Cookie ni de données client sensibles à une adresse inconnue.