API Quickstart: Connect Your Client to Our Uncensored Model
Αυτό το γρήγορο ξεκίνημα δείχνει πώς να κατευθύνετε ένα OpenAI-compatible client στο uncensored text model μας. Χρειάζεστε μία base URL, ένα model id και το key σας.
Authentication and Base URL
Κάθε αίτηση στέλνεται στο https://doesgrokhaveanapi.com/v1 και περιέχει το κλειδί σας στο Authorization header ως bearer token. Αντιγράψτε το κλειδί από τη σελίδα Get API key· εμφανίζεται μόλις εγγραφείτε και μπορείτε να το αντικαταστήσετε οποιαδήποτε στιγμή.
Σύντομα και άμεσα: το base URL και το key είναι οι μόνοι δύο τιμές που αλλάζουν όταν μεταφέρετε έναν υπάρχοντα client.
curl https://api.doesgrokhaveanapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
}'
Το Τερματικό Chat Completions
Αποστολή POST /v1/chat/completions με μια λίστα μηνυμάτων. Η απάντηση έχει την ίδια δομή με την απάντηση OpenAI chat completions, ώστε οι υπάρχοντες parsers να συνεχίζουν να λειτουργούν.
- Χρησιμοποιήστε τον ρόλο
userγια το prompt σας καιsystemγια οδηγίες. - Διαβάστε την απάντηση από
choices[0].message.content. - Οι μετρήσεις tokens επιστρέφονται σε
usage, και γι' αυτό χρεώνεται το credit σας.
from openai import OpenAI
client = OpenAI(base_url="https://api.doesgrokhaveanapi.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)
Υποστηριζόμενο Μοντέλο: 'uncensored'
Ορίστε το πεδίο model στο uncensored. Αυτό είναι το μοναδικό model id στην υπηρεσία, οπότε δεν υπάρχει κάτι να επιλέξετε. GET /v1/models το επιστρέφει, που είναι ένας γρήγορος τρόπος να επιβεβαιώσετε ότι το κλειδί λειτουργεί.
Το μοντέλο είναι ένα μοντέλο ανοιχτού βάρους που εκτελείται στους δικούς μας διακομιστές. Δεν απορρίπτει αιτήματα νόμιμου ενήλικου, φανταστικού ή αμφιλεγόμενου περιεχομένου. Το μόνο αυστηρό όριο είναι το σεξουαλικό περιεχόμενο που αφορά ανηλίκους.
Ροή δεδομένων και Κλήση Συναρτήσεων
Add stream: true για να λάβετε tokens ως server-sent events. Το τελευταίο chunk περιέχει τους αριθμούς χρήσης, ώστε να μπορείτε να καταγράψτε το κόστος ανά αίτημα χωρίς δεύτερη κλήση.
Το Function calling λειτουργεί μέσω του τυπικού tools και tool_choice πεδία. Ορίστε κάθε συνάρτηση με ένα JSON schema και διαβάστε το tool_calls του αντικειμένου της απάντησης.
stream = 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)
Παράμετροι: Temperature, Top P, και Stop
Οι υποστηριζόμενες παραμέτροι δειγματοληψίας είναι temperature, top_p, stop, seed, presence_penalty και frequency_penalty. Χρησιμοποιήστε χαμηλή temperature για code και extraction, και υψηλότερη για fiction.
If you do not set max_tokens, το default output limit είναι 2,048 tokens. Το hard maximum ανά request είναι 16,000 tokens.
Λειτουργία JSON και Μορφές Απόκρισης
Ορίστε response_format για { 'type': 'json_object' } όταν χρειάζεστε machine-readable output. Ζητήστε JSON στο prompt επίσης, επειδή το μοντέλο ακολουθεί την εντολή και τη μορφή μαζί.
- Περιγράψτε τα πεδία που χρειάζεστε στο system message.
- Κρατήστε το παράδειγμα σύντομο, δύο ή τρεις ключες.
- Επαληθεύστε το αποτέλεσμα στον κώδικά σας πριν το αποθηκεύσετε.
Όρια Ρυθμού και Διαχείριση Σφαλμάτων
Κάθε κλειδί μπορεί να στείλει 300 αιτήσεις ανά λεπτό και 8 αιτήσεις ταυτόχρονα. Αιτήσεις με σώμα άνω των 8 MB απορρίπτονται. Το 401 σημαίνει ότι το κλειδί είναι λάθος, το 402 σημαίνει ότι εξαντλήθηκαν τα χρήματα και το 429 σημαίνει ότι φτάσατε στο όριο ρυθμού: περιμένετε και δοκιμάστε ξανά με backoff.
Τα σφάλματα και οι απορρίψεις δεν χρεώνονται. Έχετε υπόψη σας το context window των 100.000 tokens για μακριές συνομιλίες: το prompt και η completion μετρώνται μαζί.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.doesgrokhaveanapi.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);Frequently asked questions
Ποια base URL πρέπει να χρησιμοποιήσω;
Χρησιμοποιήστε το https://doesgrokhaveanapi.com/v1 ως τη βάση URL. Οποιοδήποτε SDK συμβατό με OpenAI το αποδέχεται όταν αλλάζετε τη βάση URL και το κλειδί, χωρίς να χρειάζεται να αλλάξετε τίποτα άλλο στον κώδικά σας.
Ποιο model id στέλνω;
Στείλτε uncensored. Είναι το μοναδικό μοντέλο στην υπηρεσία. Καλέστε GET /v1/models για να επιβεβαιώσετε το id και ότι το κλειδί σας είναι ενεργό πριν τρέξετε μεγαλύτερες εργασίες.
Γιατί η αίτησή μου επιστρέφει 402;
Ένα response 402 σημαίνει ότι το prepaid credit στον λογαριασμό εξαντλήθηκε. Προσθέστε credit με USDT σε TRC20 ή USDC σε Base από $20, και το επόμενο request θα περάσει. Τα αποτυχημένα requests δεν χρεώνονται.
Το API key σας είναι ένα βήμα μακριά
Εγγραφείτε, αντιγράψτε το token σας, ενημερώστε το endpoint. Αυτή είναι όλη η διαδικασία.