Τεκμηρίωση API Grock

Γρήγορη Έναρξη: Πρώτο Αίτημα

Ξεκινήστε κατευθύνοντας τον πελάτη σας στη βάση URL μας. Χρησιμοποιήστε https://api.grockapi.com/v1 και ορίστε το API key σας στον header. Ο ταυτοποιητής μοντέλου είναι πάντα uncensored. Αυτό λειτουργεί με οποιοδήποτε OpenAI-compatible SDK.

Η πιστοποίηση απαιτεί ένα έγκυρο διακριτικό Bearer. Περάστε το ως Authorization: Bearer YOUR_API_KEY. Αν το κλειδί λείπει ή είναι λανθασμένο, λαμβάνετε άμεσα σφάλμα 401.

Κάντε την πρώτη σας κλήση για να δοκιμάσετε τη σύνδεση. Το body της αίτησης πρέπει να περιλαμβάνει το όνομα του μοντέλου και ένα messages array.

Υποστηριζόμενες Παράμετροι και Λειτουργίες

Ρυθμίστε τη συμπεριφορά δημιουργίας χρησιμοποιώντας τυπικές παραμέτρους. Μπορείτε να προσαρμόσετε τη θερμοκρασία για δημιουργικότητα ή το top_p για δειγματοληψία πυρήνα. Χρησιμοποιήστε την παράμετρο stop για να ορίσετε συγκεκριμένες ακολουθίες που διακόπτουν τη δημιουργία.

Ορίστε seed για προσδιοριστικές εξόδους κατά την αποσφαλμάτωση. Τα penalties παρουσίας και συχνότητας βοηθούν στη μείωση της επανάληψης. Το μοντέλο υποστηρίζει έως 100.000 tokens στο παράθυρο συμφραζομένων.

Η μέγιστη έξοδος περιορίζεται σε 16.000 tokens ανά αίτημα. Αφήστε το max_tokens μη ορισμένο για να χρησιμοποιήσετε το όριο εξόδου προεπιλογής 2.048. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό υπόλοιπο.

Ροή και Χρήση Tokens

Ενεργοποιήστε streaming ρυθμίζοντας stream: true. Η API επιστρέφει chunks μέσω Server-Sent Events (SSE). Κάθε chunk περιέχει μερικό περιεχόμενο και μεταδεδομένα.

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

Διαχειριστείτε σωστά τον τερματισμό της ροής (stream) για να αποφύγετε διαρροές πόρων. Επεξεργαστείτε πάντα το τελευταίο κομμάτι (chunk) για να λάβετε ακριβή δεδομένα χρέωσης.

Συνάρτηση Calling (Εργαλεία)

Ορίστε εργαλεία στο σώμα του αιτήματος. Προσδιορίστε ονόματα εργαλείων, περιγραφές και σχήματα παραμέτρων. Το μοντέλο απαντά με κλήσεις εργαλείων όταν είναι κατάλληλο.

Χρησιμοποιήστε την παράμετρο tool_choice για να αναγκάσετε ή να επιτρέψετε συγκεκριμένες συμπεριφορές. Μπορείτε να το ορίσετε σε auto, required, ή συγκεκριμένα IDs εργαλείων.

Επεξεργαστείτε κλήσεις εργαλείων στη λογική της εφαρμογής σας. Στείλτε την έξοδο του εργαλείου πίσω στο μοντέλο για να συνεχίσετε τη συζήτηση. Αυτό επιτρέπει πολύπλοκες ροές εργασίας πολλαπλών βημάτων χωρίς εξωτερική ανάλυση.

Λειτουργία JSON και Περιορισμοί

Εξαναγκασμός δομημένης εξόδου ορίζοντας response_format σε json_object. Το μοντέλο θα επιστρέψει JSON χωρίς μπλοκ κώδικα markdown.

Αυτή η λειτουργία είναι ιδανική για την ανάλυση δεδομένων σε εφαρμογές. Βεβαιωθείτε ότι το σχήμα σας είναι σαφές για να βελτιώσετε την ακρίβεια. Οι μη έγκυρες δομές JSON μπορεί να προκαλέσουν σφάλματα ανάλυσης στον πελάτη σας.

Συνδυάστε τη λειτουργία JSON με ελέγχους θερμοκρασίας για συνεπή μορφοποίηση. Χρησιμοποιήστε ακολουθίες διακοπής (stop sequences) για να αποτρέψετε χαρακτήρες που ακολουθούν μετά το κλείσιμο της αγκύλης.

Όρια Ρυθμού και Όρια Χρήσης

Κάθε κλειδί API περιορίζεται σε 300 αιτήσεις ανά λεπτό. Μπορείτε να εκτελέσετε έως 8 ταυτόχρονες αιτήσεις ταυτόχρονα. Το μέγιστο μέγεθος του σώματος της αίτησης είναι 8 MB.

Σφάλμα 429 υποδεικνύετε ότι ξεπεράσατε το όριο ταχύτητας. Περιμένετε πριν επαναλάβετε ή μειώστε την ταυτόχρονη χρήση. Υπάρχει ένα ενεργό κλειδί ανά λογαριασμό· η δημιουργία νέου κλειδιού αντικαθιστά το παλιό.

Παρακολουθήστε τη χρήση σας μέσω του τελευταίου chunk ροής ή των headers της απόκρισης. Σφάλματα όπως 402 (χωρίς πιστωτικό υπόλοιπο) ή 401 (μη έγκυρο κλειδί) είναι δωρεάν και δεν μετράνε στο όριο χρήσης σας.

cURL

Copycurl https://api.grockapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate the sum of two and three"}]
  }'

Python

Copyfrom openai import OpenAI

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

Ροή

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)