GitHub Uncensored AI API Reference
Ενσωματώστε την LLM χωρίς λογοκρισία στις εφαρμογές σας με ένα τυπικό σημείο τερματισμού συμβατό με OpenAI. Λαμβάνετε άμεση δημιουργία κειμένου χωρίς φίλτρα περιεχομένου, προπληρωμένη χρέωση κρυπτονομισμάτων και παράθυρο πλαισίου 100.000 tokens.
Πιστοποίηση & Base URL
Η API απαιτεί bearer token για κάθε αίτημα. Δημιουργείτε αυτό το κλειδί άμεσα μέσω του dashboard χρησιμοποιώντας διαπιστευτήρια Google ή email. Μόλις δημιουργηθεί, το κλειδί πιστοποιεί τον προκαταβλημένο λογαριασμό σας απέναντι στο φιλοξενούμενο μοντέλο.
Ορίστε το base URL ώστε να κατευθύνεται απευθείας στην πύλη API μας. Αυτό διασφαλίζει ότι όλα τα αιτήματα κατευθύνονται στον σωστό διακομιστή μοντέλου uncensored.
Χρησιμοποιήστε τον τυπικό header Authorization με το scheme Bearer. Αντικαταστήστε το placeholder με το μοναδικό string κλειδιού σας.
Βασική Διαμόρφωση
- Base URL:
https://api.githubuncensoredai.com/v1 - Κεφαλίδα Auth:
Authorization: Bearer YOUR_API_KEY - ID Μοντέλου:
uncensored
curl https://api.githubuncensoredai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
}'
Τερματικό Συμπληρώματος Συζήτησης
Στείλτε δεδομένα κειμένου στο endpoint chat completions και λάβτε δημιουργημένο κείμενο ως απάντηση. Το σύστημα δέχεται μια λίστα μηνυμάτων με ρόλους όπως user ή assistant. Επιστρέφει μια ολοκλήρωση βασισμένη στην ιστορία prompts.
Αυτό το endpoint διαχειρίζεται τυπικές ροές συνομιλίας. Μπορείτε να στείλετε πολλαπλές στροφές (turns), και το μοντέλο διατηρεί το πλαίσιο έως το όριο. Δεν υποστηρίζει εισόδους εικόνας, ήχου ή βίντεο. Η μορφή απάντησης είναι τυπικό JSON.
Βεβαιωθείτε ότι το payload σας περιλαμβάνει τον αναγνωριστικό του μοντέλου. Το σύστημα αγνοεί ομαλά άγνωστα πεδία. Τα σφάλματα επιστρέφουν συγκεκριμένους κωδικούς αν αποτύχει η πιστοποίηση ή εξαντληθούν τα credits.
from openai import OpenAI
client = OpenAI(base_url="https://api.githubuncensoredai.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)
Streaming Αποκρίσεις
Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας τη σημαία stream σε true. Η API επιστρέφει μια σειρά από Server-Sent Events αντί για ένα μοναδικό αντικείμενο JSON. Κάθε γεγονός περιέχει ένα chunk του παραγόμενου κειμένου.
Αυτή η προσέγγιση μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές απαντήσεις. Μπορείτε να ξεκινήσετε να εμφανίζετε κείμενο στους χρήστες καθώς παράγεται. Το τελευταίο κομμάτι περιλαμβάνει στατιστικά χρήσης tokens για χρέωση.
Διαχειριστείτε τη ροή αποδοτικά στον κώδικα του πελάτη. Κλείστε τη σύνδεση όταν η ροή ολοκληρωθεί ή προκύψει σφάλμα. Αυτή η μέθοδος λειτουργεί καλά για διεπαφές συνομιλίας σε πραγματικό χρόνο.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.githubuncensoredai.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);
Συνάρτηση Calling & JSON Mode
Το μοντέλο υποστηρίζει δομημένη έξοδο μέσω κλήσης συναρτήσεων. Ορίστε εργαλεία στην αίτησή σας με ονόματα, περιγραφές και σχήματα παραμέτρων. Το μοντέλο επιλέγει το κατάλληλο εργαλείο και δημιουργεί ορίσματα.
Χρησιμοποιήστε JSON mode για αυστηρή συμμόρφωση σχήματος. Ορίστε τη μορφή εξόδου σε json_object για να αναγκάσετε έγκυρη έξοδο JSON. Αυτό είναι χρήσιμο για την ανάλυση δεδομένων ή τη δημιουργία αποσπασμάτων κώδικα.
Συνδυάστε κλήση συναρτήσεων με streaming για διαδραστικές εμπειρίες. Το μοντέλο μπορεί να καλέσει πολλαπλά εργαλεία με τη σειρά. Επαληθεύστε το σχήμα εξόδου πριν εκτελέσετε συναρτήσεις στη λογική της εφαρμογής σας.
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)
Parameters & Limits
Ελέγξτε τη συμπεριφορά δημιουργίας με παραμέτρους όπως temperature και top_p. Προσαρμόστε αυτές τις τιμές για να ισορροπήσετε τη δημιουργικότητα και τον ντετερμινισμό. Οι προεπιλεγμένες ρυθμίσεις λειτουργούν για τις περισσότερες γενικές περιπτώσεις.
Σεβαστείτε τα όρια αιτημάτων για να αποφύγετε σφάλματα. Μπορείτε να στείλετε έως 300 αιτήματα ανά λεπτό ανά κλειδί. Οι ταυτόχρονες συνδέσεις περιορίζονται στα οκτώ ανά κλειδί. Το μέγιστο μέγεθος του σώματος αιτήματος είναι 8 MB.
Το παράθυρο πλαισίου καλύπτει 100.000 tokens. Αυτό περιλαμβάνει τόσο tokens εντολής εισόδου όσο και ολοκλήρωσης. Η έξοδος περιορίζεται σε 16.000 tokens ανά αίτημα. Η υπέρβαση αυτών των ορίων επιστρέφει κωδικό σφάλματος.
Χρήση & Χρέωση Token
Η χρέωση είναι προκαταβλημένη και βασίζεται στην πραγματική χρήση tokens. Τα input tokens κοστίζουν $0.15 ανά εκατομμύριο, και τα output tokens κοστίζουν $0.50 ανά εκατομμύριο. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικά.
Το υπόλοιπο δεν λήγει ποτέ. Οι φορτώσεις επεξεργάζονται αποκλειστικά μέσω κρυπτονομισμάτων. Λαμβάνετε bonus υπόλοιπο για μεγαλύτερες καταθέσεις. Το σύστημα καταγράφει ακριβώς τη χρήση για κάθε κλειδί API.
Παρακολουθήστε το υπόλοιπό σας μέσω του πίνακα ελέγχου. Αν τα πιστωτικά εξαντληθούν, οι αιτήσεις σας θα αποτύχουν με έναν συγκεκριμένο κωδικό σφάλματος. Προσθέστε κεφάλαια ακαριαία για να ανακτήσετε την υπηρεσία χωρίς να περιμένετε εγκρίσεις.
Συχνές ερωτήσεις
Πώς διαχειρίζομαι σφάλματα ελέγχου ταυτότητας;
Αν λάβετε σφάλμα 401, το API key σας είναι άκυρο ή έχει λήξει. Ελέγξτε το dashboard σας για να βεβαιωθείτε ότι το key είναι ενεργό. Αναγεννήστε το key αν είναι απαραίτητο. Βεβαιωθείτε ότι χρησιμοποιείτε το σωστό base URL και το σωστό format για τα headers.
Τι συμβαίνει αν εξαντληθούν τα πιστωτικά μου;
Οι αιτήσεις θα επιστρέψουν σφάλμα 402 που υποδεικνύει ανεπαρκή κεφάλαια. Δεν χρεώνονται tokens για αυτές τις αποτυχημένες προσπάθειες. Αποθερώστε το υπόλοιπό σας κρυπτονομισμάτων για να ανακτήσετε την υπηρεσία άμεσα. Τα πιστωτικά σημεία δεν λήγουν, οπότε μπορείτε να προσθέσετε χρήματα όποτε βρείτε άνετο.
Είναι η API rate-limited;
Ναι, περιορίζεστε σε 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες συνδέσεις ανά key. Η υπέρβαση αυτών των ορίων επιστρέφει σφάλμα 429. Χρησιμοποιήστε streaming για να μειώσετε τον αριθμό των αιτημάτων για μακρές απαντήσεις. Παρακολουθήστε τη χρήση σας για να αποφύγετε την επιβράδυνση.
Δημιουργήστε το key σας σε δευτερόλεπτα
Εγγραφείτε, αποκτήστε το κλειδί σας, ενημερώστε τη βάση URL. Έγινε.