PandaNpc stocke les connexions de fournisseur et les entrées de modèle que vous configurez. Commencez par la clé API, l'URL de base, le protocole et l'ID de modèle fournis par votre service. Ajouter une entrée ne crée pas de compte en amont ni n'accorde l'accès au modèle.
Pour faire la distinction entre un fournisseur et un modèle, lisez Gérer votre liste de modèles personnalisés.
Avant de commencer
Confirmez les points suivants avec votre fournisseur ou votre service auto-hébergé :
- L'adresse de base de l'API, et non l'adresse du site web du fournisseur.
- La méthode d'authentification et toutes les informations d'identification requises.
- Le protocole API pris en charge par la fonctionnalité ou le moteur que vous prévoyez d'utiliser.
- L'ID de modèle exact que votre compte peut appeler.
- Les limites de contexte et de sortie si vous prévoyez de les saisir manuellement.
Conservez les informations d'identification dans le formulaire du fournisseur, et non dans les invites, captures d'écran ou notes partagées. Un service annoncé comme compatible OpenAI peut encore différer dans la diffusion en continu, les appels d'outils ou la prise en charge des images.
1. Ajouter ou configurer un fournisseur
Ouvrez Configuration du modèle. Ajoutez un fournisseur, configurez un préréglage existant ou copiez un préréglage lorsque vous avez besoin d'une connexion indépendamment modifiable.
| Champ | Que saisir |
|---|---|
| Nom d'affichage | Un nom reconnaissable pour cette connexion |
| Identifiant du fournisseur | Un identifiant pour la configuration du fournisseur |
| Clé API | L'information d'identification requise par votre service |
| URL de base | L'adresse de base de l'API attendue par l'intégration choisie |
| Protocole | Le format réellement implémenté par l'API en amont |
| Secret, Organisation, Projet | Uniquement les valeurs explicitement requises par votre service |
| Prise en charge du tableau de contenu | Indique si le service accepte le contenu de message structuré |
La forme de l'URL de base dépend du protocole et de la fonctionnalité qui effectue les requêtes. N'ajoutez pas un chemin d'opération complet si l'intégration l'ajoute déjà. Par exemple, une intégration qui ajoute /chat/completions nécessite l'adresse de base correspondante, et non une adresse se terminant déjà par ce chemin. N'appliquez pas cet exemple à chaque protocole.
Lors de la modification des informations d'identification stockées, laisser la clé API ou le secret vide conserve la valeur configurée. Une valeur masquée affichée dans une liste n'est pas la clé d'origine et ne doit pas être recollée comme remplacement.
2. Ajouter le modèle
Enregistrez le fournisseur, sélectionnez-le et choisissez Ajouter un modèle.
| Champ | Signification |
|---|---|
| Nom d'affichage | Votre libellé dans la liste des modèles |
| Valeur du modèle | L'ID exact du modèle en amont |
| Type de modèle | La catégorie applicable dans le formulaire de configuration |
| Fournisseur | La connexion utilisée par cette entrée |
| Fenêtre de contexte | La capacité de contexte documentée, lorsqu'elle est spécifiée |
| Max Tokens | La limite de sortie, lorsqu'elle est spécifiée |
Utilisez un ID provenant de la documentation ou de la liste des modèles du service. Un nom marketing n'est pas nécessairement un identifiant API. Laissez les limites facultatives non définies si vous ne pouvez pas les vérifier ; non défini ne signifie pas que les limites réelles ont été détectées. La fonctionnalité consommatrice peut appliquer ses propres valeurs par défaut.
3. Vérifier la configuration
Dans la fonctionnalité ou le moteur qui utilise ces paramètres :
- Sélectionnez la nouvelle entrée et démarrez une conversation de test.
- Envoyez une requête courte comme
Reply with: connected. - Confirmez une réponse normale et, le cas échéant, une requête correspondante dans les journaux d'utilisation du fournisseur.
- Envoyez un message de suivi pour vérifier la continuité de la conversation.
- Testez les images ou les appels d'outils séparément si votre travail l'exige.
Enregistrer l'entrée n'est pas un test de connexion. Une réponse textuelle n'établit pas la compatibilité avec toutes les capacités. La modification d'une entrée de modèle ne reconfigure pas non plus automatiquement un processus Claude Code ou Codex existant ; voir PandaPaw.
Dépannage
L'authentification échoue
Vérifiez si la clé est active, si le compte peut accéder au modèle et si le service exige des champs d'authentification supplémentaires. Remplacez les informations d'identification expirées via le formulaire du fournisseur.
Le point de terminaison ou le modèle est introuvable
Vérifiez à la fois l'URL de base et la valeur du modèle. Recherchez les chemins d'opération en double, un préfixe API manquant ou un ID de modèle indisponible pour votre compte. La même erreur peut avoir différentes causes selon les fournisseurs.
Une erreur réseau ou de navigateur apparaît
Vérifiez la connectivité depuis l'appareil qui envoie réellement la requête. Les requêtes provenant du navigateur sont soumises aux restrictions CORS et HTTPS ; une requête fonctionnelle depuis un autre ordinateur ne prouve pas que le parcours navigateur fonctionne.
Un serveur de modèle local est inaccessible
localhost fait référence à la machine qui effectue la requête. Il ne pointe pas automatiquement vers votre ordinateur PandaPaw distant. Confirmez où s'exécute la fonctionnalité consommatrice avant de choisir l'adresse de votre serveur local.
Le texte fonctionne mais les images, les outils ou les longues sessions échouent
Vérifiez la combinaison exacte du moteur, du protocole API et des capacités du modèle. Utilisez les limites prises en charge par le fournisseur et vérifiez chaque type d'entrée requis. L'augmentation de la fenêtre de contexte ou la modification du type de modèle n'ajoute pas de capacités en amont.
Pour la distinction entre l'appartenance à la plateforme et l'utilisation du fournisseur, voir comptes et coûts des modèles.