API-avain ja perus-URL: Lisää mukautettu AI-palveluntarjoaja

API-avaimen ja perus-URL: n määritys yhdistää mallimerkinnän valitsemaasi palveluntarjoajaan. Aseta protokolla ja mallitunnus, varmista sitten pyyntö ominaisuudessa, joka käyttää sitä.

Päivitetty

PandaNpc tallentaa palveluntarjoajayhteydet ja malli-merkinnät, jotka määrität. Aloita palvelusi toimittamasta API-avaimesta, perus-URL-osoitteesta, protokollasta ja mallitunnuksesta. Merkinnän lisääminen ei luo ylävirran tiliä tai myönnä mallin käyttöoikeutta.

Erottelusta palveluntarjoajan ja mallin välillä, lue Hallinnoi mukautettua mallilistaasi.

Ennen kuin aloitat

Vahvista seuraavat asiat palveluntarjoajaltasi tai itse ylläpidetystä palvelusta:

  • API-perusosoite, ei palveluntarjoajan verkkosivuston osoite.
  • Todennautentitapa ja mahdolliset vaaditut tunnistetiedot.
  • API-protokolla, jota käytettävä ominaisuus tai moottori tukee.
  • Tarkka mallitunnus, jota tilisi voi kutsua.
  • Konteksti- ja tulostusrajat, jos aiot syöttää ne manuaalisesti.

Säilytä tunnistetiedot palveluntarjoajan lomakkeessa, älä kehotteissa, kuvakaappauksissa tai jaetuissa muistiinpanoissa. OpenAI-yhteensopivaksi mainostettu palvelu voi silti erota suoratoistossa, työkalujen kutsuissa tai kuvien tuessa.

1. Lisää tai määritä palveluntarjoaja

Avaa Model Configuration. Lisää palveluntarjoaja, määritä olemassa oleva esiasetus tai kopioi esiasetus, kun tarvitset itsenäisesti muokattavan yhteyden.

Kenttä Mitä syötetään
Näyttönimi Tunnistettava nimi tälle yhteydelle
Palveluntarjoajan tunnus Tunniste palveluntarjoajan määritykselle
API-avain Palvelusi vaatima tunnistetieto
Perus-URL Valitun integraation odottama API-perusosoite
Protokolla Muoto, jonka ylävirran API todella toteuttaa
Salaisuus, Organisaatio, Projekti Vain arvot, jotka palvelusi nimenomaisesti vaatii
Tukee sisältötaulukkoa Hyväksyykö palvelu jäsennellyn viestisisällön

Perus-URL-osoitteen muoto riippuu protokollasta ja pyyntöjä tekevästä ominaisuudesta. Älä liitä täydellistä toimintopolkua, jos integraatio lisää sen jo itse. Esimerkiksi integraatio, joka lisää /chat/completions, tarvitsee vastaavan perusosoitteen, ei osoitetta, joka jo päättyy tähän polkuun. Älä sovella tätä esimerkkiä jokaiseen protokollaan.

Kun muokkaat tallennettuja tunnistetietoja, API-avaimen tai salaisuuden jättäminen tyhjäksi säilyttää määritetyn arvon. Luettelossa näkyvä peitetty arvo ei ole alkuperäinen avain, eikä sitä tule liittää takaisin korvauksena.

2. Lisää malli

Tallenna palveluntarjoaja, valitse se ja valitse Add Model.

Kenttä Merkitys
Näyttönimi Oma nimikkeesi malliluettelossa
Mallin arvo Tarkka ylävirran mallitunnus
Mallin tyyppi Soveltuva luokka määrityslomakkeessa
Palveluntarjoaja Yhteys, jota tämä merkintä käyttää
Konteksti-ikkuna Dokumentoitu kontekstikapasiteetti, kun sellainen on määritetty
Max Tokenit Tulostusraja, kun sellainen on määritetty

Käytä tunnusta palvelun dokumentaatiosta tai malliluettelosta. Markkinointinimi ei välttämättä ole API-tunniste. Jätä valinnaiset rajat määrittämättä, jos et voi vahvistaa niitä; määrittämätön ei tarkoita, että todelliset rajat on havaittu. Käyttävä ominaisuus voi soveltaa omia oletusarvojaan.

3. Vahvista määritys

Ominaisuudessa tai moottorissa, joka käyttää näitä asetuksia:

  1. Valitse uusi merkintä ja aloita testikeskustelu.
  2. Lähetä lyhyt pyyntö, kuten Reply with: connected.
  3. Vahvista normaali vastaus ja, jos saatavilla, vastaava pyyntö palveluntarjoajan käyttötietueissa.
  4. Lähetä jatkokysymys tarkistaaksesi jatkuvan keskustelun.
  5. Testaa kuvat tai työkalukutsut erikseen, jos työsi vaatii niitä.

Tietueen tallentaminen ei ole yhteyden testi. Tekstivastaus ei vahvista yhteensopivuutta kaikkien ominaisuuksien kanssa. Mallimerkinnän muuttaminen ei myöskään automaattisesti määritä uudelleen olemassa olevaa Claude Code- tai Codex-prosessia; katso PandaPaw.

Vianmääritys

Todennautentti epäonnistuu

Tarkista, onko avain aktiivinen, voiko tili käyttää mallia ja vaatiiko palvelu lisää todennautenttikenttiä. Korvaa vanhentuneet tunnistetiedot palveluntarjoajan lomakkeen kautta.

Päätepistettä tai mallia ei löydy

Tarkista sekä perus-URL että mallin arvo. Etsi päällekkäisiä toimintopolkuja, puuttuvaa API-etuliitettä tai mallitunnusta, joka ei ole tilisi käytettävissä. Sama virhe voi johtua eri syistä eri palveluntarjoajilla.

Verkko- tai selainvirhe ilmestyy

Tarkista yhteyden muodostaminen laitteesta, joka todella lähettää pyynnön. Selainpohjaiset pyynnöt ovat CORS- ja HTTPS-rajoitusten alaisia; toimiva pyyntö toiselta tietokoneelta ei todista, että selainpolku toimii.

Paikallista mallipalvelinta ei voi tavoittaa

localhost viittaa pyynnön tekevään koneeseen. Se ei automaattisesti osoita etäiseen PandaPaw-tietokoneeseesi. Vahvista, missä käyttävä ominaisuus toimii, ennen kuin valitset paikallisen palvelimesi osoitteen.

Teksti toimii, mutta kuvat, työkalut tai pitkät istunnot epäonnistuvat

Tarkista moottorin, API-protokollan ja mallin ominaisuuksien tarkka yhdistelmä. Käytä palveluntarjoajan tukemia rajoja ja varmista jokainen vaadittu syötetyyppi. Konteksti-ikkunan suurentaminen tai mallin tyypin muuttaminen ei lisää ylävirran ominaisuuksia.

Erottelusta alustan jäsenyyden ja palveluntarjoajan käytön välillä, katso tilit ja mallikustannukset.