Documentazione API

Autenticazione e Base URL

Inizia generando la tua chiave tramite la dashboard. Usa l'URL base https://api.grokapipricing.com/v1 per tutte le richieste. Imposta il Authorization header per Bearer YOUR_API_KEY. Una singola chiave funziona su tutti gli endpoint. Ruotala liberamente se necessario.

POST /v1/chat/completions

Invia i tuoi prompt all'endpoint chat. L'ID del modello è sempre uncensored. Configura parametri come temperature o top_p per controllare la creatività. Le risposte restituiscono completamenti di chat standard con metadati sull'utilizzo dei token. Errori come 402 o 429 indicano problemi di fatturazione o limiti di frequenza.

GET /v1/models

Verifica i modelli disponibili inviando una richiesta GET all'endpoint dei modelli. Vedrai il uncensored modello elencato. Questo conferma la connettività e la disponibilità del modello. Utilizza questo per il debug delle configurazioni del client prima di inviare payload pesanti.

Utilizzo Streaming e SSE

Abilita lo streaming impostando stream: true nel corpo della richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Le statistiche di utilizzo dei token appaiono nell'ultimo chunk dello stream. Questo riduce la latenza percepita per le risposte lunghe.

Function Calling e modalità JSON

Usa response_format con {"type": "json_object"} per output JSON rigorosi. Abilita il function calling definendo tools nella tua richiesta. Il modello supporta tool_choice per l'esecuzione forzata o automatica. Questo garantisce un'integrazione affidabile con la logica del tuo backend.

Limiti di frequenza e vincoli

Hai un limite di 300 richieste al minuto per chiave. La concorrenza è limitata a 8 richieste simultanee. La dimensione massima del corpo della richiesta è di 8 MB. La finestra di contesto consente 100.000 token in totale. Le richieste che superano questi limiti ricevono immediatamente errori 429 o 400.

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)