API-nøgle og Base URL: Tilføj en Tilpasset AI-udbyder

API-nøgle og Base URL-konfiguration forbinder en modelpost til din valgte udbyder. Angiv protokollen og model-ID'et, og verificer derefter en anmodning i funktionen, der bruger den.

Opdateret

PandaNpc gemmer udbyderforbindelser og modelposter, som du konfigurerer. Start med API-nøglen, basis-URL'en, protokollen og model-ID'en, som din tjeneste leverer. Tilføjelse af en post opretter ikke en opstrømskonto eller giver modeladgang.

For forskellen mellem en udbyder og en model, læs Administrer din brugerdefinerede modeliste.

Før du begynder

Bekræft følgende med din udbyder eller selvhostede tjeneste:

  • API-basisadressen, ikke udbyderens webstedsadresse.
  • Godkendelsesmetoden og eventuelle nødvendige legitimationsoplysninger.
  • Den API-protokol, som den funktion eller motor, du har til hensigt at bruge, understøtter.
  • Det præcise model-ID, som din konto kan kalde.
  • Kontekst- og outputgrænser, hvis du planlægger at indtaste dem manuelt.

Opbevar legitimationsoplysninger i udbyderformularen, ikke i prompter, skærmbilleder eller delte noter. En tjeneste, der annonceres som OpenAI-kompatibel, kan stadig afvige i streaming, værktøjskald eller billedsupport.

1. Tilføj eller konfigurer en udbyder

Åbn Modelkonfiguration. Tilføj en udbyder, konfigurer en eksisterende forudindstilling, eller kopier en forudindstilling, når du har brug for en uafhængigt redigerbar forbindelse.

Felt Hvad skal indtastes
Vist navn Et genkendeligt navn for denne forbindelse
Udbyder-ID En identifikator for udbyderkonfigurationen
API-nøgle Den legitimationsoplysning, som din tjeneste kræver
Basis-URL Den API-basisadresse, som den valgte integration forventer
Protokol Det format, som opstrøms-API'en faktisk implementerer
Hemmelighed, organisation, projekt Kun værdier, der udtrykkeligt kræves af din tjeneste
Understøt indholdsarray Om tjenesten accepterer struktureret beskedindhold

Basis-URL'ens form afhænger af protokollen og den funktion, der foretager anmodninger. Tilføj ikke en komplet driftssti, hvis integrationen allerede tilføjer den. For eksempel har en integration, der tilføjer /chat/completions, brug for den tilsvarende basisadresse, ikke en adresse, der allerede ender med den sti. Anvend ikke det eksempel på hver protokol.

Når du redigerer gemte legitimationsoplysninger, bevares den konfigurerede værdi, hvis du lader API-nøglen eller hemmeligheden være tom. En maskeret værdi, der vises i en liste, er ikke den originale nøgle og bør ikke indsættes tilbage som en erstatning.

2. Tilføj modellen

Gem udbyderen, vælg den, og vælg Tilføj model.

Felt Betydning
Vist navn Din etiket i modelisten
Modelværdi Det præcise opstrømsmodel-ID
Modeltype Den relevante kategori i konfigurationsformularen
Udbyder Den forbindelse, som denne post bruger
Kontekstvindue Den dokumenterede kontekstkapacitet, når angivet
Maks. tokens Outputgrænsen, når angivet

Brug et ID fra tjenestens dokumentation eller modeliste. Et marketingnavn er ikke nødvendigvis en API-identifikator. Lad valgfrie grænser forblive usat, hvis du ikke kan verificere dem; usat betyder ikke, at de reelle grænser er blevet registreret. Den forbrugende funktion kan anvende sine egne standardindstillinger.

3. Verificer konfigurationen

I den funktion eller motor, der bruger disse indstillinger:

  1. Vælg den nye post, og start en testkonversation.
  2. Send en kort anmodning som Svar med: forbundet.
  3. Bekræft et normalt svar og, hvor tilgængeligt, en matchende anmodning i udbyderens brugsposter.
  4. Send en opfølgning for at kontrollere kontinuerlig konversation.
  5. Test billeder eller værktøjskald separat, hvis dit arbejde kræver det.

At gemme posten er ikke en forbindelsestest. En tekstrespons etablerer ikke kompatibilitet med alle funktioner. At ændre en modelpost genkonfigurerer heller ikke automatisk en eksisterende Claude Code- eller Codex-proces; se PandaPaw.

Fejlfinding

Godkendelse mislykkes

Kontroller, om nøglen er aktiv, kontoen kan få adgang til modellen, og tjenesten kræver yderligere godkendelsesfelter. Udskift udløbne legitimationsoplysninger via udbyderformularen.

Endepunktet eller modellen findes ikke

Kontroller både basis-URL'en og modelværdien. Se efter duplikerede driftsstier, en manglende API-præfiks eller et model-ID, der ikke er tilgængeligt for din konto. Den samme fejl kan have forskellige årsager på tværs af udbydere.

En netværks- eller browserfejl vises

Kontroller forbindelsen fra den enhed, der faktisk sender anmodningen. Browser-origerede anmodninger er underlagt CORS- og HTTPS-begrænsninger; en fungerende anmodning fra en anden computer beviser ikke, at browserstien fungerer.

En lokal modelserver kan ikke nås

localhost henviser til den maskine, der foretager anmodningen. Det peger ikke automatisk på din eksterne PandaPaw-computer. Bekræft, hvor den forbrugende funktion kører, før du vælger adressen på din lokale server.

Tekst virker, men billeder, værktøjer eller lange sessioner mislykkes

Kontroller den nøjagtige kombination af motor, API-protokol og modelkapaciteter. Brug udbyderstøttede grænser, og verificer hver påkrævet inputtype. At øge kontekstvinduet eller ændre modeltypen tilføjer ikke opstrømskapaciteter.

For forskellen mellem platformmedlemskab og udbyderbrug, se konti og modelomkostninger.