API Key și Base URL: adaugă un furnizor AI personalizat

Configurarea API Key și Base URL conectează o intrare de model la furnizorul ales. Setează protocolul și ID-ul modelului, apoi verifică o cerere în funcția care îl folosește.

Actualizat

PandaNpc stochează conexiunile furnizorilor și intrările de modele pe care le configurați. Începeți cu Cheia API, URL-ul de bază, protocolul și ID-ul modelului furnizate de serviciul dumneavoastră. Adăugarea unei intrări nu creează un cont upstream și nici nu acordă acces la model.

Pentru distincția dintre un furnizor și un model, citiți Gestionați lista personalizată de modele.

Înainte de a începe

Confirmați următoarele cu furnizorul sau serviciul auto-găzduit:

  • Adresa de bază a API-ului, nu adresa site-ului furnizorului.
  • Metoda de autentificare și orice acreditări necesare.
  • Protocolul API acceptat de funcția sau motorul pe care intenționați să îl utilizați.
  • ID-ul exact al modelului pe care contul dumneavoastră îl poate apela.
  • Limitele de context și de ieșire dacă intenționați să le introduceți manual.

Păstrați acreditările în formularul furnizorului, nu în prompturi, capturi de ecran sau note partajate. Un serviciu promovat ca fiind compatibil OpenAI poate diferi totuși în ceea ce privește streaming-ul, apelurile de instrumente sau suportul pentru imagini.

1. Adăugați sau configurați un furnizor

Deschideți Configurare model. Adăugați un furnizor, configurați un preset existent sau copiați un preset atunci când aveți nevoie de o conexiune editabilă independent.

Câmp Ce să introduceți
Nume afișat Un nume recunoscut pentru această conexiune
ID furnizor Un identificator pentru configurația furnizorului
Cheie API Acreditarea cerută de serviciul dumneavoastră
URL de bază Adresa de bază a API-ului așteptată de integrarea aleasă
Protocol Formatul pe care API-ul upstream îl implementează efectiv
Secret, Organizație, Proiect Doar valorile cerute explicit de serviciul dumneavoastră
Suport matrice de conținut Dacă serviciul acceptă conținut de mesaje structurat

Forma URL-ului de bază depinde de protocol și de funcția care face cererile. Nu adăugați o cale completă de operațiune dacă integrarea o adaugă deja. De exemplu, o integrare care adaugă /chat/completions necesită adresa de bază corespunzătoare, nu o adresă care se termină deja cu acea cale. Nu aplicați acest exemplu fiecărui protocol.

Când editați acreditările stocate, lăsarea Cheii API sau a Secretului necompletat păstrează valoarea configurată. O valoare mascată afișată într-o listă nu este cheia originală și nu trebuie lipită înapoi ca înlocuitor.

2. Adăugați modelul

Salvați furnizorul, selectați-l și alegeți Adăugați model.

Câmp Semnificație
Nume afișat Eticheta dumneavoastră în lista de modele
Valoare model ID-ul exact al modelului upstream
Tip model Categoria aplicabilă în formularul de configurare
Furnizor Conexiunea folosită de această intrare
Fereastră de context Capacitatea de context documentată, când este specificată
Tokeni maximi Limita de ieșire, când este specificată

Utilizați un ID din documentația serviciului sau din lista de modele. Un nume de marketing nu este neapărat un identificator API. Lăsați limitele opționale nesetate dacă nu le puteți verifica; nesetat nu înseamnă că limitele reale au fost detectate. Funcția consumatoare poate aplica propriile valori implicite.

3. Verificați configurația

În funcția sau motorul care utilizează aceste setări:

  1. Selectați noua intrare și începeți o conversație de test.
  2. Trimiteți o cerere scurtă, cum ar fi Răspunde cu: conectat.
  3. Confirmați un răspuns normal și, acolo unde este disponibil, o cerere corespunzătoare în înregistrările de utilizare ale furnizorului.
  4. Trimiteți un mesaj ulterior pentru a verifica conversația continuă.
  5. Testați imaginile sau apelurile de instrumente separat dacă munca dumneavoastră le necesită.

Salvarea înregistrării nu este un test de conexiune. Un răspuns text nu stabilește compatibilitatea cu fiecare capacitate. Modificarea unei intrări de model nu reconfigurare automat un proces existent Claude Code sau Codex; consultați PandaPaw.

Depanare

Autentificarea eșuează

Verificați dacă cheia este activă, dacă contul poate accesa modelul și dacă serviciul necesită câmpuri suplimentare de autentificare. Înlocuiți acreditările expirate prin formularul furnizorului.

Endpoint-ul sau modelul nu este găsit

Verificați atât URL-ul de bază, cât și Valoarea modelului. Căutați căi duplicate de operațiune, un prefix API lipsă sau un ID de model indisponibil pentru contul dumneavoastră. Aceeași eroare poate avea cauze diferite la diferiți furnizori.

Apare o eroare de rețea sau de browser

Verificați conectivitatea de pe dispozitivul care trimite efectiv cererea. Cererile originate din browser sunt supuse restricțiilor CORS și HTTPS; o cerere reușită de pe alt computer nu dovedește că calea din browser funcționează.

Un server de model local nu poate fi accesat

localhost se referă la mașina care face cererea. Nu indică automat computerul dumneavoastră PandaPaw de la distanță. Confirmați unde rulează funcția consumatoare înainte de a alege adresa serverului local.

Textul funcționează, dar imaginile, instrumentele sau sesiunile lungi eșuează

Verificați combinația exactă de motor, protocol API și capabilități ale modelului. Utilizați limitele acceptate de furnizor și verificați fiecare tip de intrare necesar. Creșterea Ferestrei de context sau schimbarea Tipului de model nu adaugă capabilități upstream.

Pentru distincția dintre apartenența la platformă și utilizarea furnizorului, consultați conturi și costuri de model.