Introducere rapidă API: Conectează-ți clientul la modelul nostru fără cenzură

Autentificare și URL de bază

Fiecare cerere merge la https://doesgrokhaveanapi.com/v1 și include cheia ta în Authorization header ca token bearer. Copiază cheia din pagina Get API key; aceasta este afișată o singură dată după înregistrare, iar o poți înlocui oricând.

Scurt și direct: URL-ul de bază și cheia sunt singurele două valori care se schimbă când migrezi un client existent.

Copycurl https://api.doesgrokhaveanapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
  }'

Endpoint-ul Chat Completări

Trimite POST /v1/chat/completions cu o listă de mesaje. Răspunsul are aceeași structură ca răspunsul de completări chat OpenAI, astfel încât analizatorii existenți să continue să funcționeze.

• Folosește rolul user pentru promptul tău și system pentru instrucțiuni.
• Citește răspunsul de la choices[0].message.content.
• Numărătoarea de tokeni este returnată în usage, iar creditul tău este debitat pentru aceasta.

Copyfrom openai import OpenAI

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

Model suportat: 'uncensored'

Setează câmpul model la uncensored. Acesta este singurul id de model disponibil pe serviciu, deci nu ai ce să alegi. GET /v1/models returnează-l, ceea ce este o modalitate rapidă de a confirma că cheia funcționează.

Modelul este un model open-weight care rulează pe serverele noastre proprii. Nu refuză solicitările legale pentru adulți, fictive sau controversate. Singura limită strictă este conținutul sexual care implică minori.

Streaming și apeluri de funcții

Adaugă stream: true pentru a primi tokeni ca evenimente server-sent. Blocul final conține numerele de utilizare, astfel încât să poți loga costul per cerere fără o a doua apelare.

Function calling funcționează prin standardul tools și tool_choice câmpuri. Definește fiecare funcție cu un schema JSON și citește tool_calls array-ul răspunsului.

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)

Parametri: Temperatură, Top P și Stop

Parametrii de eșantionare acceptați sunt temperature, top_p, stop, seed, presence_penalty și frequency_penalty. Folosește o temperatură mică pentru cod și extragere, și una mai mare pentru ficțiune.

Dacă nu setezi max_tokens, limita implicită de ieșire este de 2.048 tokeni. Maximul absolut per solicitare este de 16.000 de tokeni.

Mod JSON și Formate de răspuns

Setează response_format pentru { 'type': 'json_object' } când ai nevoie de un output lizibil de mașină. Cere JSON în prompt, deoarece modelul urmează instrucțiunea și formatul împreună.

1. Descrie câmpurile de care ai nevoie în mesajul de sistem.
2. Mențineți exemplul scurt, două sau trei chei.
3. Validează rezultatul în codul tău înainte de a-l stoca.

Limite de rată și gestionarea erorilor

Fiecare cheie poate trimite 300 de cereri pe minut și 8 cereri simultan. Cererile cu un corp peste 8 MB sunt respinse. Un 401 înseamnă că cheia este greșită, un 402 înseamnă că creditul s-a epuizat, iar un 429 înseamnă că ai atins limita de rată: așteaptă și reîncearcă cu backoff.

Erorile și refuzurile nu sunt facturate. Ține cont de fereastra de context de 100.000 de tokeni pentru fire lungi: promptul și completarea numărate împreună.

Node.js

Copyimport OpenAI from "openai";

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