API-nøkkel og base-URL: Legg til en egendefinert AI-leverandør

API-nøkkel- og base-URL-konfigurasjon kobler en modelloppføring til din valgte leverandør. Angi protokollen og modell-ID-en, og verifiser deretter en forespørsel i funksjonen som bruker den.

Oppdatert

PandaNpc lagrer leverandørforbindelser og modelloppføringer du konfigurerer. Start med API-nøkkelen, Base URL, protokollen og modell-ID-en som tjenesten din har gitt deg. Det å legge til en oppføring oppretter ikke en oppstrømskonto eller gir modelltilgang.

For skillet mellom en leverandør og en modell, les Administrer din egendefinerte modelliste.

Før du begynner

Bekreft følgende med leverandøren din eller den selv-hostede tjenesten:

  • API-basadressen, ikke leverandørens nettstedadresse.
  • Autentiseringsmetoden og eventuelle nødvendige legitimasjonsopplysninger.
  • API-protokollen som støttes av funksjonen eller motoren du har tenkt å bruke.
  • Den eksakte modell-ID-en kontoen din kan kalle.
  • Kontekst- og utdata-grenser hvis du planlegger å oppgi dem manuelt.

Oppbevar legitimasjonsopplysninger i leverandørskjemaet, ikke i ledetekster, skjermbilder eller delte notater. En tjeneste som annonseres som OpenAI-kompatibel, kan fortsatt avvike i strømming, verktøykall eller bildestøtte.

1. Legg til eller konfigurer en leverandør

Åpne Modellkonfigurasjon. Legg til en leverandør, konfigurer en eksisterende forhåndsinnstilling, eller kopier en forhåndsinnstilling når du trenger en uavhengig redigerbar forbindelse.

Felt Hva du skal oppgi
Visningsnavn Et gjenkjennelig navn for denne forbindelsen
Leverandør-ID En identifikator for leverandørkonfigurasjonen
API-nøkkel Legitimasjonen som kreves av tjenesten din
Base URL API-basadressen som forventes av den valgte integrasjonen
Protokoll Formatet som oppstrøms-API-en faktisk implementerer
Hemmelighet, Organisasjon, Prosjekt Bare verdier som uttrykkelig kreves av tjenesten din
Støtter innholdsarray Om tjenesten godtar strukturert meldingsinnhold

Formen på Base URL avhenger av protokollen og funksjonen som sender forespørslene. Ikke legg til en full operasjonsbane hvis integrasjonen allerede legger den til. For eksempel trenger en integrasjon som legger til /chat/completions den tilsvarende basadressen, ikke en adresse som allerede ender med denne banen. Ikke bruk dette eksempelet på alle protokoller.

Når du redigerer lagrede legitimasjonsopplysninger, vil det å la API-nøkkelen eller hemmeligheten stå tom bevare den konfigurerte verdien. En maskert verdi som vises i en liste, er ikke den opprinnelige nøkkelen og bør ikke limes tilbake som en erstatning.

2. Legg til modellen

Lagre leverandøren, velg den og velg Legg til modell.

Felt Betydning
Visningsnavn Etiketten din i modellisten
Modellverdi Den eksakte oppstrøms modell-ID-en
Modelltype Den relevante kategorien i konfigurasjonsskjemaet
Leverandør Forbindelsen som denne oppføringen bruker
Kontekstvindu Den dokumenterte kontekstkapasiteten, når den er spesifisert
Maks tokens Utdatagrensen, når den er spesifisert

Bruk en ID fra tjenestens dokumentasjon eller modelliste. Et markedsføringsnavn er ikke nødvendigvis en API-identifikator. La valgfrie grenser stå usatt hvis du ikke kan verifisere dem; usatt betyr ikke at de reelle grensene er oppdaget. Funksjonen som bruker innstillingene, kan bruke sine egne standardverdier.

3. Verifiser konfigurasjonen

I funksjonen eller motoren som bruker disse innstillingene:

  1. Velg den nye oppføringen og start en testkonversasjon.
  2. Send en kort forespørsel som Svar med: tilkoblet.
  3. Bekreft et normalt svar og, der det er tilgjengelig, en samsvarende forespørsel i leverandørens bruksregistre.
  4. Send en oppfølging for å sjekke kontinuerlig konversasjon.
  5. Test bilder eller verktøykall separat hvis arbeidet ditt krever det.

Det å lagre posten er ikke en tilkoblingstest. Et tekstsvar etablerer ikke kompatibilitet med alle funksjoner. Det å endre en modelloppføring konfigurerer heller ikke automatisk om en eksisterende Claude Code- eller Codex-prosess; se PandaPaw.

Feilsøking

Autentisering mislykkes

Sjekk om nøkkelen er aktiv, om kontoen kan få tilgang til modellen, og om tjenesten krever ekstra autentiseringsfelt. Erstatt utgått legitimasjon gjennom leverandørskjemaet.

Endepunktet eller modellen blir ikke funnet

Sjekk både Base URL og modellverdi. Se etter dupliserte operasjonsbaner, en manglende API-prefiks eller en modell-ID som ikke er tilgjengelig for kontoen din. Den samme feilen kan ha forskjellige årsaker på tvers av leverandører.

En nettverks- eller nettleserfeil vises

Sjekk tilkoblingen fra enheten som faktisk sender forespørselen. Forespørsler som stammer fra nettleseren, er underlagt CORS- og HTTPS-begrensninger; en fungerende forespørsel fra en annen datamaskin beviser ikke at nettleserbanen fungerer.

En lokal modellserver kan ikke nås

localhost refererer til maskinen som sender forespørselen. Den peker ikke automatisk til din eksterne PandaPaw-datamaskin. Bekreft hvor funksjonen som bruker innstillingene kjører, før du velger adressen til den lokale serveren din.

Tekst fungerer, men bilder, verktøy eller lange økter mislykkes

Sjekk den eksakte kombinasjonen av motor, API-protokoll og modellfunksjoner. Bruk leverandørstøttede grenser og verifiser hver nødvendig inndatatype. Å øke kontekstvinduet eller endre modelltypen legger ikke til oppstrømsfunksjoner.

For skillet mellom plattformmedlemskap og leverandørbruk, se kontoer og modellkostnader.