PandaNpc slaat providerverbindingen en modelvermeldingen op die u configureert. Begin met de API-sleutel, basis-URL, protocol en model-ID die door uw service worden verstrekt. Het toevoegen van een vermelding creëert geen upstream-account of verleent geen modeltoegang.
Voor het onderscheid tussen een provider en een model, lees Beheer uw aangepaste modellijst.
Voordat u begint
Bevestig het volgende met uw provider of zelfgehoste service:
- Het API-basisadres, niet het websiteadres van de provider.
- De authenticatiemethode en eventuele vereiste referenties.
- Het API-protocol dat wordt ondersteund door de functie of engine die u wilt gebruiken.
- De exacte model-ID die uw account kan aanroepen.
- Context- en uitvoerlimieten als u deze handmatig wilt invoeren.
Bewaar referenties in het providerformulier, niet in prompts, schermafbeeldingen of gedeelde notities. Een service die wordt geadverteerd als OpenAI-compatibel kan nog steeds verschillen in streaming, toolcalls of afbeeldingsondersteuning.
1. Een provider toevoegen of configureren
Open Modelconfiguratie. Voeg een provider toe, configureer een bestaande voorinstelling of kopieer een voorinstelling wanneer u een onafhankelijk bewerkbare verbinding nodig heeft.
| Veld | Wat in te vullen |
|---|---|
| Weergavenaam | Een herkenbare naam voor deze verbinding |
| Provider-ID | Een identificatie voor de providerconfiguratie |
| API-sleutel | De referentie die uw service vereist |
| Basis-URL | Het API-basisadres dat door de gekozen integratie wordt verwacht |
| Protocol | Het formaat dat de upstream-API daadwerkelijk implementeert |
| Geheim, Organisatie, Project | Alleen waarden die expliciet door uw service worden vereist |
| Ondersteuning inhoudarray | Of de service gestructureerde berichtinhoud accepteert |
De vorm van de basis-URL hangt af van het protocol en de functie die verzoeken doet. Voeg geen volledig bewerkingpad toe als de integratie dit al toevoegt. Bijvoorbeeld, een integratie die /chat/completions toevoegt, heeft het overeenkomstige basisadres nodig, niet een adres dat al eindigt met dat pad. Pas dat voorbeeld niet toe op elk protocol.
Bij het bewerken van opgeslagen referenties laat het leeg laten van de API-sleutel of het geheim de geconfigureerde waarde behouden. Een gemaskeerde waarde die in een lijst wordt getoond, is niet de originele sleutel en moet niet als vervanging worden teruggeplakt.
2. Het model toevoegen
Sla de provider op, selecteer deze en kies Model toevoegen.
| Veld | Betekenis |
|---|---|
| Weergavenaam | Uw label in de modellijst |
| Modelwaarde | De exacte upstream-model-ID |
| Modeltype | De toepasselijke categorie in het configuratieformulier |
| Provider | De verbinding die deze vermelding gebruikt |
| Contextvenster | De gedocumenteerde contextcapaciteit, indien gespecificeerd |
| Max tokens | De uitvoerlimiet, indien gespecificeerd |
Gebruik een ID uit de documentatie of modellijst van de service. Een marketingnaam is niet noodzakelijkerwijs een API-identificatie. Laat optionele limieten niet ingesteld als u ze niet kunt verifiëren; niet ingesteld betekent niet dat de echte limieten zijn gedetecteerd. De gebruikte functie kan zijn eigen standaardwaarden toepassen.
3. De configuratie verifiëren
In de functie of engine die deze instellingen gebruikt:
- Selecteer de nieuwe vermelding en start een testgesprek.
- Stuur een kort verzoek zoals
Antwoord met: verbonden. - Bevestig een normaal antwoord en, indien beschikbaar, een overeenkomend verzoek in de gebruiksrecords van de provider.
- Stuur een vervolgbericht om continu gesprek te controleren.
- Test afbeeldingen of toolcalls afzonderlijk als uw werk deze vereist.
Het opslaan van het record is geen verbindingstest. Een tekstreactie bevestigt geen compatibiliteit met elke mogelijkheid. Het wijzigen van een modelvermelding reconfigureert ook niet automatisch een bestaand Claude Code- of Codex-proces; zie PandaPaw.
Probleemoplossing
Authenticatie mislukt
Controleer of de sleutel actief is, of het account toegang heeft tot het model, en of de service extra authenticatievelden vereist. Vervang verlopen referenties via het providerformulier.
Het eindpunt of model wordt niet gevonden
Controleer zowel de basis-URL als de modelwaarde. Zoek naar dubbele bewerkingspaden, een ontbrekend API-voorvoegsel of een model-ID die niet beschikbaar is voor uw account. Dezelfde fout kan verschillende oorzaken hebben bij verschillende providers.
Er verschijnt een netwerk- of browserfout
Controleer de connectiviteit vanaf het apparaat dat daadwerkelijk het verzoek verzendt. Verzoeken die vanuit de browser worden gestart, zijn onderworpen aan CORS- en HTTPS-beperkingen; een werkend verzoek vanaf een andere computer bewijst niet dat het browserpad werkt.
Een lokaal modelserver kan niet worden bereikt
localhost verwijst naar de machine die het verzoek doet. Het verwijst niet automatisch naar uw externe PandaPaw-computer. Bevestig waar de gebruikte functie draait voordat u het adres van uw lokale server kiest.
Tekst werkt, maar afbeeldingen, tools of lange sessies mislukken
Controleer de exacte combinatie van engine, API-protocol en modelmogelijkheden. Gebruik door de provider ondersteunde limieten en verifieer elk vereist invoertype. Het verhogen van het contextvenster of het wijzigen van het modeltype voegt geen upstream-mogelijkheden toe.
Voor het onderscheid tussen platformlidmaatschap en providergebruik, zie accounts en modelkosten.