API-Dokumentation

Authentifizierung und Basis-URL

Die Base-URL für alle Anfragen ist https://api.grokapiplatform.com/v1. Authentifizieren Sie sich, indem Sie Ihren eindeutigen API-Schlüssel im Authorization header. Jede Anfrage muss diesen Header enthalten, um Ihr Kontoguthaben zu überprüfen und Ratenbegrenzungen anzuwenden.

Chat-Vervollständigungs-Endpunkt

Senden Sie Textabfragen an POST /v1/chat/completions. Die zu verwendende Modell-ID ist "uncensored". Dieser Endpunkt verarbeitet Standard-Texteingaben und Textausgaben, ohne dass für die Basisnutzung zusätzliche Konfigurationen erforderlich sind.

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."}]
  }'

Das Modell arbeitet mit einem Kontextfenster von 100.000 Tokens. Eingabe- und Ausgabetokens teilen sich dieses Limit. Anfragen, die das Kontextfenster überschreiten, schlagen sofort fehl.

Streaming-Antworten mit SSE

Aktivieren Sie Streaming, indem Sie stream: true in Ihrem Anfragekörper. Der Server gibt Server-Sent Events (SSE) mit inkrementellen Token-Aktualisierungen zurück. Verwenden Sie dies für Echtzeit-Anzeigen oder um die wahrgenommene Latenz zu reduzieren.

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)

Die Token-Nutzungsdetails erscheinen im letzten Chunk des Streams. Sie können den Gesamtverbrauch pro Anfrage verfolgen, ohne jeden einzelnen Delta-Wert zu analysieren.

Funktionsaufruf und Tools

Definieren Sie Tools in der tools Array und festlegen tool_choice um spezifisches Verhalten auszulösen. Das Modell unterstützt Standard-Muster für die Werkzeugnutzung, die mit OpenAI-SDKs kompatibel sind.

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);

Verwenden tool_choice: "auto" für automatische Auswahl oder geben Sie einen Tool-Namen für die erzwungene Ausführung an. Dies funktioniert nahtlos mit dem unzensierten Modell für komplexe Aufgaben.

JSON-Modus für strukturierte Ausgaben

Festlegen response_format zu {"type": "json_object"} um strenge JSON-Ausgabe zu erzwingen. Dies reduziert Analysefehler bei der Integration mit Frontend-Anwendungen oder Datenpipelines.

Parameter und Limits

Anpassen temperature, top_p, und seed um Zufälligkeit zu steuern. Die maximale Ausgabe pro Anfrage beträgt 16.000 Token. Fehler wie 401 deuten auf ungültige Schlüssel hin, 402 bedeutet unzureichendes vorausbezahltes Guthaben und 429 signalisiert Ratenbegrenzungen. Das Limit beträgt 300 Anfragen pro Minute pro Schlüssel. Guthaben verfällt nie, sodass Sie jederzeit mit USDT oder USDC aufladen können.

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)