Quickstart: Integrați chat-ul apertus ai

Precondiții și configurare

Începeți prin a crea un cont și obțineți cheia API. Înregistrați-vă folosind Google sau o parolă de email în pagina de generare a cheii. Sistemul afișează cheia imediat, astfel încât să o puteți copia fără întârziere. Nu este necesar un număr de telefon pentru înregistrare. Primești $0.50 în credit de probă valabil timp de 7 zile, astfel încât să poți testa conectivitatea fără a adăuga fonduri.

Configurați variabila de mediu sau clientul SDK pentru a indica către URL-ul de bază corect. Acest URL funcționează cu librăriile standard OpenAI. Schimbați doar URL-ul de bază și cheia dvs. ID-ul modelului este "uncensored". Acest singur endpoint gestionează toate completările de text. Nu trebuie să gestionați redirecționarea sau să selectați modele diferite.

Asigură-te că biblioteca clientului suportă protocolul OpenAI Chat Completions. Majoritatea SDK-urilor moderne funcționează din cutie. Verifică dacă rețeaua ta permite cereri HTTPS de ieșire. Serviciul acceptă payload-uri JSON standard. Nu sunt necesare antete speciale în afară de autentificare.

Autentificare cu chei API

Transmiteți cheia API în antetul Authorization pentru fiecare solicitare. Utilizați schema Bearer urmată de șirul cheii dumneavoastră. Serviciul validează cheia împotriva contului dumneavoastră. Cheile invalide returnează eroarea 401 Unauthorized. Cheile expirate sau soldul insuficient declanșează răspunsul 402 Payment Required. Verificați-vă soldul din panoul de control dacă solicitările eșuează.

Mențineți cheia în siguranță. Fiecare cont deține o singură cheie activă. Generarea unei noi chei invalidează pe cea anterioară. Nu distribuiți cheia în depozitele publice. Cheia API este singurul identificator pentru utilizarea dvs. Limitele de rată se aplică per cheie, nu per cont.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

Autentificarea este fără stare. Serverul verifică tokenul la fiecare apel. Dacă îți rotireați cheia, actualizează imediat toți clienții în execuție. Lipsa antetului duce la respingerea imediată. Mesajul de eroare indică clar eșecul de autentificare.

Trimiterea primei cereri

Trimiteți o cerere POST către endpoint-ul de completări chat. Includeți ID-ul modelului "uncensored" și istoricul mesajelor. API-ul returnează un răspuns text. Puteți streamui output-ul sau puteți aștepta finalizarea completă. Fiecare cerere consumă tokeni de intrare și ieșire. Erorile nu încarcă creditele. Refuzurile sunt gratuite.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Răspunsul include statistici de utilizare. Urmăriți consumul de tokeni pentru a vă gestiona creditul preplătit. Modelul răspunde fără refuzuri de conținut pentru uz adult legal. Puteți trimite mesaje de sistem pentru a defini comportamentul. Mesajele utilizatorului ghidează conversația. Fereastra de context suportă un total de 100.000 de tokeni.

Începe cu un schimb simplu de două mesaje. Acesta verifică conectivitatea și calitatea răspunsului. Ajustează temperatura și top_p pentru outputuri creative sau precise. API-ul suportă parametrii standard. Secvențele de oprire funcționează așa cum se așteaptă. Valorile seed asigură rezultate reproductibile.

Răspunsuri în streaming prin SSE

Activați streaming-ul setând parametrul stream la true. API-ul returnează Evenimente trimise de server (SSE) în loc de un singur obiect JSON. Fiecare fragment conține o parte din textul generat. Citiți fragmentele până când fluxul se termină. Fragmentul final include utilizarea totală a tokenilor.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Streaming-ul reduce latența percepută. Utilizatorii văd textul apărând în timp real. Acest lucru este ideal pentru interfețele de chat. Gestionează cu grijă tokenii parțiali. Concatenează fragmentele pentru a forma răspunsul complet. Serverul închide conexiunea când generarea se termină.

Monitorizați erorile de stream. Întreruperile de rețea pot anula stream-ul. Implementați logica de reconectare dacă este necesar. API-ul nu retrimite istoricul. Începeți o nouă cerere dacă stream-ul eșuează. Numerele de tokeni din ultimul chunk reflectă întreaga generare.

Gestionarea parametrilor și modurilor

Folosește parametri standard pentru a controla generarea. Setează temperature pentru aleatorietate. Ajustează top_p pentru eșantionarea nucleu. Definește secvențe de oprire pentru a întrerupe generarea devreme. Transmite un seed pentru ieșiri deterministe. Activează modul JSON setând response_format la json_object. Modelul returnează JSON valid când este solicitat.

Funcționarea prin apeluri de funcții este suportată. Definiți instrumente în cerere. Modelul returnează apeluri de instrumente când este potrivit. Analizați argumentele instrumentului în codul dumneavoastră. Transmiteți rezultatele înapoi pentru a continua conversația. Acest lucru permite fluxuri de lucru complexe pentru agenți.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusaichat.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Tokenii maximi limitează lungimea ieșirii. Implicit sunt 2,048 de tokeni. Setează o valoare mai mare dacă este necesar. Limita strictă per solicitare este de 16,000 de tokeni. Fereastra de context este de 100,000 de tokeni. Planifică lungimea istoricului în consecință. Penalizările de frecvență și prezență ajută la reducerea repetării.

Înțelegerea limitelor și erorilor

Limitările de rată protejează stabilitatea serviciului. Poți trimite 300 de cereri pe minut. Concurența este limitată la opt cereri simultane per cheie. Corpurile cererilor nu trebuie să depășească 8 MB. Depășirea limitelor returnează o eroare 429 Too Many Errors. Așteaptă înainte de a reîncerca.

Verificați codurile de eroare pentru diagnosticare. 401 înseamnă cheie invalidă sau lipsă. 402 indică credit preplătit insuficient. Reîncărcați prin cripto pentru a relua serviciul. 429 semnalează limitarea ratei. 400 denotă o sintaxă de cerere greșită. Consultați mesajul de eroare pentru detalii.

Gestionarea ferestrei de context este critică. Numără token-ii de prompt și completari. Menține-te cu mult sub 100.000 de tokeni. Taie mesajele vechi dacă este necesar. API-ul nu taie automat. Tu controlezi lungimea istoricului. Utilizarea eficientă a contextului reduce costurile.