Documentație API

URL de bază și autentificare

Conectați aplicația indicând către endpoint-ul nostru dedicat și trecând cheia dvs. API unică. URL-ul de bază pentru toate solicitările este https://api.apertusapp.com/v1. Obții cheia imediat după înregistrare prin Google sau email pe Obține cheie API pagina. Include această cheie în Authorization header pentru fiecare solicitare.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Fiecare cont generează o cheie activă. Dacă generezi o cheie nouă, cea precedentă devine invalidă instantaneu. Acest lucru asigură un control strict asupra accesului tău, fără abonații sau taxe de inactivitate.

Prima cerere

Trimite primul tău prompt către endpoint-ul de completări chat pentru a primi text brut, nefiltrat. Folosește ID-ul modelului uncensored pentru a accesa modelul nostru specific open-weight ajustat pentru subiecte adulte legale și controversate.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusapp.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)

API-ul acceptă parametri standard precum temperature și top_p. Erorile și respingerile nu consumă tokeni, așa că plătiți doar pentru ceea ce ajunge efectiv la model. Această abordare menține costurile predictibile comparativ cu agregatoarele care percep taxe pentru suprasarcina de rutare.

Integrare SDK Node

Folosește SDK-ul oficial Node pentru a gestiona modul JSON și apelarea de funcții în mod eficient. Setează response_format pentru {"type": "json_object"} pentru output-uri structurate sau definește tool-uri pentru un comportament de tip agent.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusapp.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);

Modelul suportă apeluri de instrumente cu tool_choice opțiuni. De asemenea, puteți seta un seed pentru rezultate deterministe. Această flexibilitate îți permite să construiești aplicații complexe fără a părăsi ecosistemul compatibil cu OpenAI.

Răspunsuri streaming

Transmiteți tokenii în timp real folosind Evenimente Trimise de Server (SSE) pentru experiențe utilizator cu latență redusă. Fiecare bucată conține textul generat, iar ultima bucată include statisticile totale de utilizare 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ă pentru utilizatorii finali. Poți întrerupe fluxul dacă utilizatorul își schimbă părerea. API-ul gestionează protocolul SSE automat, necesitând minim de cod din partea ta.

Fereastră de context și capacitate

Modelul suportă o fereastră de context de 100.000 de tokeni pentru input și output combinate. Puteți specifica până la 16.000 de tokeni per cerere, sau puteți reveni la 2.048 de tokeni dacă omiteți max_tokens.

Această fereastră mare permite analiza extensivă a documentelor sau istorice de conversații lungi. Totuși, menține corpurile solicitărilor sub 8 MB. Modelul nu este GPT sau Llama; este un model distinct de AI fără cenzură, optimizat pentru cazul tău specific de utilizare.

Gestionarea erorilor și limitele

Gestionați erorile standard HTTP cu grijă pentru a menține un flux robust al aplicației. Un 401 eroare indică o cheie API invalidă sau lipsă. O 402 eroare înseamnă că creditul dvs. preplătit este epuizat. O 429 eroare semnalează că ați depășit 300 de cereri pe minut sau 8 cereri concurente.

Credit-ul nu expiră, așa că poți întrerupe utilizarea și să reia mai târziu. Greșelile, cum ar fi dublele charge-uri, sunt rezolvate prin pagina de Suport. Creditul preplătit este taxat doar pentru consumul real de tokeni, asigurând o facturare transparentă pentru fiecare byte.