Documentație API

Autentificare și URL de bază

URL-ul de bază pentru toate solicitările este https://api.grokapiplatform.com/v1. Autentificați-vă trecând cheia API unică în Authorization header. Fiecare cerere trebuie să includă acest header pentru a verifica soldul contului tău și a aplica limitele de rată.

Endpoint Completări Chat

Trimite interogări text către POST /v1/chat/completions. ID-ul modelului de utilizat este "uncensored". Acest endpoint gestionează interacțiuni standard de tip text-in, text-out, fără a necesita configurații suplimentare pentru utilizarea de bază.

Copycurl https://api.grokapiplatform.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check my current token usage balance."}]
  }'

Modelul operează cu o fereastră de context de 100,000 de tokeni. Tokenii de input și output împart această limită. Solicitățile care depășesc fereastra de context vor eșua imediat.

Răspunsuri în flux cu SSE

Activați streaming-ul setând stream: true în corpul cererii tale. Serverul returnează Evenimente trimise de server (SSE) cu actualizări incrementale ale tokenilor. Folosește acest lucru pentru afișări în timp real sau pentru a reduce latența percepută.

Copyfrom openai import OpenAI

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

Detaliile de consum de tokenuri apar în ultimul fragment al fluxului. Puteți urmări consumul total per solicitare fără a analiza fiecare delta intermediar.

Apelarea funcțiilor și instrumentele

Definește instrumente în tools array și setează tool_choice pentru a declanșa comportamente specifice. Modelul suportă modele standard de utilizare a uneltelor compatibile cu SDK-urile OpenAI.

Copyimport OpenAI from "openai";

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

Utilizare tool_choice: "auto" pentru selectare automată sau specifică unui nume de instrument pentru execuție forțată. Acest lucru funcționează perfect cu modelul fără cenzură pentru sarcini complexe de raționament.

Modul JSON pentru ieșiri structurate

Setează response_format pentru {"type": "json_object"} pentru a impune ieșirea strictă JSON. Acest lucru reduce erorile de analizare când te integrezi cu aplicații frontend sau pipeline-uri de date.

Parametri și limite

Ajustați temperature, top_p, și seed pentru a controla aleatorietatea. Outputul maxim per solicitare este de 16.000 de tokeni. Erorile precum 401 indică chei invalide, 402 înseamnă credit preplătit insuficient, iar 429 semnalează limite de rată. Limita este de 300 de solicitări pe minut per cheie. Creditul nu expiră niciodată, astfel încât poți reîncărca cu USDT sau USDC oricând este nevoie.

Streaming

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)