API-nyckel och bas-URL: Lägg till en anpassad AI-leverantör

API-nyckel och bas-URL-konfiguration ansluter en modellpost till din valda leverantör. Ange protokollet och modell-ID:et, verifiera sedan en begäran i funktionen som använder den.

Uppdaterad

PandaNpc lagrar leverantörsanslutningar och modellposter som du konfigurerar. Börja med API-nyckeln, bas-URL:en, protokollet och modell-ID:t som din tjänst tillhandahåller. Att lägga till en post skapar inte ett uppströmskonto eller beviljar modellåtkomst.

För skillnaden mellan en leverantör och en modell, läs Hantera din anpassade modellista.

Innan du börjar

Bekräfta följande med din leverantör eller självhostade tjänst:

  • API-basadressen, inte leverantörens webbplatsadress.
  • Autentiseringsmetoden och eventuella nödvändiga inloggningsuppgifter.
  • API-protokollet som stöds av funktionen eller motorn du tänker använda.
  • Det exakta modell-ID:t som ditt konto kan anropa.
  • Kontext- och utdatabegränsningar om du planerar att ange dem manuellt.

Förvara inloggningsuppgifter i leverantörsformuläret, inte i uppmaningar, skärmbilder eller delade anteckningar. En tjänst som annonseras som OpenAI-kompatibel kan fortfarande skilja sig åt i strömning, verktygsanrop eller bildstöd.

1. Lägg till eller konfigurera en leverantör

Öppna Modellkonfiguration. Lägg till en leverantör, konfigurera en befintlig förinställning eller kopiera en förinställning när du behöver en oberoende redigerbar anslutning.

Fält Vad du ska ange
Visningsnamn Ett igenkännligt namn för denna anslutning
Leverantörs-ID En identifierare för leverantörskonfigurationen
API-nyckel Den inloggningsuppgift som krävs av din tjänst
Bas-URL Den API-basadress som förväntas av den valda integrationen
Protokoll Det format som det uppströms API:t faktiskt implementerar
Hemlighet, organisation, projekt Endast värden som uttryckligen krävs av din tjänst
Stöd för content-array Om tjänsten accepterar strukturerat meddelandeinnehåll

Bas-URL:ens form beror på protokollet och funktionen som gör förfrågningar. Lägg inte till en fullständig åtgärdssökväg om integrationen redan lägger till den. Till exempel behöver en integration som lägger till /chat/completions motsvarande basadress, inte en adress som redan slutar med den sökvägen. Tillämpa inte det exemplet på varje protokoll.

När du redigerar lagrade inloggningsuppgifter, lämna API-nyckeln eller hemligheten tom för att bevara det konfigurerade värdet. Ett maskerat värde som visas i en lista är inte den ursprungliga nyckeln och ska inte klistras tillbaka som ersättning.

2. Lägg till modellen

Spara leverantören, välj den och välj Lägg till modell.

Fält Betydelse
Visningsnamn Din etikett i modellistan
Modellvärde Det exakta uppströms modell-ID:t
Modelltyp Den tillämpliga kategorin i konfigurationsformuläret
Leverantör Den anslutning som denna post använder
Kontextfönster Den dokumenterade kontextkapaciteten, när den anges
Max-token Utdata begränsningen, när den anges

Använd ett ID från tjänstens dokumentation eller modellista. Ett marknadsföringsnamn är inte nödvändigtvis en API-identifierare. Lämna valfria begränsningar osatta om du inte kan verifiera dem; osatt betyder inte att de verkliga begränsningarna har upptäckts. Den användande funktionen kan tillämpa egna standardvärden.

3. Verifiera konfigurationen

I funktionen eller motorn som använder dessa inställningar:

  1. Välj den nya posten och starta en testkonversation.
  2. Skicka en kort förfrågan som Svara med: ansluten.
  3. Bekräfta ett normalt svar och, där tillgängligt, en matchande förfrågan i leverantörens användningsregister.
  4. Skicka en uppföljning för att kontrollera kontinuerlig konversation.
  5. Testa bilder eller verktygsanrop separat om ditt arbete kräver det.

Att spara posten är inte ett anslutningstest. Ett text svar fastställer inte kompatibilitet med varje funktion. Att ändra en modellpost konfigurerar inte heller automatiskt om en befintlig Claude Code- eller Codex-process; se PandaPaw.

Felsökning

Autentisering misslyckas

Kontrollera om nyckeln är aktiv, om kontot kan komma åt modellen och om tjänsten kräver ytterligare autentiseringsfält. Byt ut utgångna inloggningsuppgifter via leverantörsformuläret.

Slutpunkten eller modellen hittas inte

Kontrollera både bas-URL:en och modellvärdet. Leta efter dubbletter av åtgärdssökvägar, en saknad API-prefix eller ett modell-ID som inte är tillgängligt för ditt konto. Samma fel kan ha olika orsaker hos olika leverantörer.

Ett nätverks- eller webbläsarfel visas

Kontrollera anslutningen från enheten som faktiskt skickar förfrågan. Förfrågningar som härrör från webbläsaren är föremål för CORS- och HTTPS-begränsningar; en fungerande begäran från en annan dator bevisar inte att webbläsarsökvägen fungerar.

En lokal modellserver kan inte nås

localhost hänvisar till datorn som gör förfrågan. Den pekar inte automatiskt på din fjärrdator med PandaPaw. Bekräfta var den användande funktionen körs innan du väljer adressen till din lokala server.

Text fungerar men bilder, verktyg eller långa sessioner misslyckas

Kontrollera den exakta kombinationen av motor, API-protokoll och modellfunktioner. Använd leverantörsstödda begränsningar och verifiera varje obligatorisk inmatningstyp. Att öka kontextfönstret eller ändra modelltyp lägger inte till uppströmsfunktioner.

För skillnaden mellan plattformsmedlemskap och leverantörsanvändning, se konton och modellkostnader.