Τεκμηρίωση API

Πιστοποίηση και base URL

Η base URL για όλες τις αιτήσεις είναι https://api.grokapiplatform.com/v1. Πραγματοποιήστε έλεγχο ταυτότητας περνώντας το μοναδικό σας API key στο Authorization header. Κάθε αίτημα πρέπει να περιλαμβάνει αυτό το header για να επαληθεύσει το υπόλοιπο του λογαριασμού σας και να εφαρμόσει τα όρια ρυθμού.

Τερματικό συμπληρώματος συζήτησης

Στείλτε ερωτήματα κειμένου στο POST /v1/chat/completions. Το ID του μοντέλου που θα χρησιμοποιήσετε είναι "uncensored". Αυτή η διεπαφή χειρίζεται αλληλεπιδράσεις τυπικής εισόδου/εξόδου κειμένου χωρίς να απαιτεί επιπλέον διαμόρφωση για βασική χρήση.

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

Το μοντέλο λειτουργεί με παράθυρο συνάφειας 100,000 tokens. Τα tokens εισόδου και εξόδου μοιράζονται αυτό το όριο. Οι αιτήσεις που υπερβαίνουν το παράθυρο συνάφειας θα αποτύχουν άμεσα.

Ροή αποκρίσεων με SSE

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στο σώμα του αιτήματός σας. Ο εξυπηρετητής επιστρέφει Server-Sent Events (SSE) με σταδιακές ενημερώσεις tokens. Χρησιμοποιήστε το για πραγματικές εμφανίσεις ή για μείωση της αντιλαμβανόμενης καθυστέρησης.

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)

Τα λεπτομερή δεδομένα χρήσης token εμφανίζονται στο τελευταίο chunk της ροής. Μπορείτε να παρακολουθήσετε τη συνολική κατανάλωση ανά αίτημα χωρίς να επεξεργαστείτε κάθε ενδιάμεσο delta.

Κλήση συναρτήσεων και εργαλεία

Ορίστε εργαλεία στο tools array και ορίστε tool_choice για να ενεργοποιήσετε συγκεκριμένες συμπεριφορές. Το μοντέλο υποστηρίζει τυπικά μοτίβα χρήσης εργαλείων συμβατά με τα SDKs 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);

Χρήση tool_choice: "auto" για αυτόματη επιλογή ή καθορίστε ένα όνομα εργαλείου για αναγκαστική εκτέλεση. Αυτό λειτουργεί άψογα με το uncensored μοντέλο για σύνθετες εργασίες λογικής.

Λειτουργία JSON για δομημένη έξοδο

Ορίστε response_format για {"type": "json_object"} για να επιβάλετε αυστηρό JSON output. Αυτό μειώνει τα σφάλματα parsing όταν ενσωματώνεστε με frontend εφαρμογές ή data pipelines.

Παράμετροι και όρια

Ρύθμιση temperature, top_p, και seed για τον έλεγχο τυχαίοτητας. Η μέγιστη έξοδος ανά αίτηση είναι 16.000 tokens. Σφάλματα όπως 401 υποδηλώνουν μη έγκυρα κλειδιά, 402 σημαίνει ανεπαρκές προπληρωμένο πιστωτικό υπόλοιπο, και 429 σηματοδοτεί όρια ρυθμού. Το όριο είναι 300 αιτήσεις ανά λεπτό ανά κλειδί. Το πιστωτικό υπόλοιπο δεν λήγει, οπότε μπορείτε να το συμπληρώσετε με USDT ή USDC όποτε χρειαστεί.

Ροή

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)