Τεκμηρίωση API & Γρήγορη Έναρξη

Βασικό URL και Αυθεντικοποίηση

Ξεκινήστε ρυθμίζοντας τη base URL σε HTTPS://api.uncensoredal.com/v1 και περνώντας το API key σας στην header Authorization. Λαμβάνετε ένα ενεργό key ανά λογαριασμό και η δημιουργία ενός νέου key ακυρώνει άμεσα το προηγούμενο. Αυτή η απλή ρύθμιση λειτουργεί με οποιοδήποτε τυπικό OpenAI-compatible client χωρίς πολύπλοκη λογική διαδρομής.

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

Το endpoint είναι αυστηρά για chat completions, οπότε δεν χρειάζεται να διαχειρίζεστε την διαδρομή μοντέλων. Κάθε αίτημα πρέπει να περιλαμβάνει τον αναγνωριστικό μοντέλου "uncensored" για να διασφαλίσετε ότι χτυπάτε τον σωστό server inference. Οι αποτυχίες ελέγχου ταυτότητας επιστρέφουν status 401 αν το key λείπει ή είναι άκυρο.

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

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredal.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, με τα σφάλματα και τις απορρίψεις να παραμένουν δωρεάν. Αυτό το προπληρωμένο μοντέλο σημαίνει ότι πληρώνετε μόνο για αυτό που καταναλώνετε. Το endpoint υποστηρίζει τυπικές παραμέτρους όπως temperature και top_p για τον έλεγχο της τυχαιότητας της εξόδου.

Streaming Αποκρίσεις με SSE

Ενεργοποιήστε streaming ρυθμίζοντας stream σε true στο σώμα του αιτήματος για να λάβετε tokens μέσω Server-Sent Events. Κάθε chunk περιλαμβάνει στατιστικά χρήσης token στο τελευταίο chunk, επιτρέποντάς σας να παρακολουθείτε το κόστος σε πραγματικό χρόνο. Αυτή η προσέγγιση μειώνει την αντιλαμβανόμενη καθυστέρηση για μεγάλες παραγωγές.

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)

Χρησιμοποιήστε streaming όταν χτίζετε διεπαφές chat που χρειάζονται εμφάνιση κειμένου καθώς παράγεται. Το API επιστρέφει συμβατά stream events OpenAI-compatible, διευκολύνοντας την ενσωμάτωση με υπάρχουσες βιβλιοθήκες UI. Μπορείτε να διακόψετε το stream νωρίτερα αν ο χρήστης αλλάξει την είσοδό του.

Function Calling και JSON Mode

Ορίστε εργαλεία στο αίτημά σας για να ενεργοποιήσετε κλήση συναρτήσεων ή να εξαναγκάσετε την έξοδο JSON χρησιμοποιώντας το response_format. Το API υποστηρίζει το tool_choice για ακριβέ έλεγχο του πότε το μοντέλο πρέπει να καλέσει μια συνάρτηση. Αυτή η λειτουργία λειτουργεί με το τυπικό σχήμα OpenAI, ώστε να μπορείτε να επαναχρησιμοποιήσετε υπάρχοντες ορισμούς εργαλείων.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredal.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);

Η λειτουργία JSON εξασφαλίζει ότι η έξοδος είναι έγκυρο JSON, το οποίο είναι χρήσιμο για την ανάλυση δομημένων δεδομένων προγραμματιστικά. Μπορείτε να συνδυάσετε αυτό με ρυθμίσεις temperature για να ισορροπήσετε τη δημιουργικότητα με τη δομική αξιοπιστία. Το API διαχειρίζεται τη λογική εκτέλεσης εργαλείων επιστρέφοντας τις λεπτομέρειες κλήσης συνάρτησης για να τις επεξεργαστεί ο κώδικάς σας.

Διαμόρφωση Παραμέτρων Μοντέλου

Ρυθμίστε παραμέτρους όπως θερμοκρασία, top_p, ακολουθίες stop και seed για τον έλεγχο της συμπεριφοράς δημιουργίας. Το παράθυρο πλαισίου υποστηρίζει 100.000 tokens για prompt και ολοκλήρωση συνδυαστικά. Η μέγιστη έξοδος περιορίζεται σε 16.000 tokens ανά αίτημα, ή 2.048 αν δεν καθορίσετε max_tokens.

Μπορείτε να χρησιμοποιήσετε presence_penalty και frequency_penalty για να μειώσετε την επανάληψη σε μακρύτερα κείμενα. Αυτές οι παράμετροι επιτρέπουν τον εκλεπτυσμένο έλεγχο του στυλ του μοντέλου χωρίς να αλλάξουν τα υπόκλινα βάρη. Προσαρμόστε τα σταδιακά για να βρείτε την ισορροπία που ταιριάζει στην συγκεκριμένη περίπτωσή σας.

Όρια, Σφάλματα και Context

Τα όρια ρυθμού ορίζονται στα 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες συνδέσεις ανά κλειδί. Τα σώματα αιτημάτων περιορίζονται στα 8 MB, οπότε τα μεγάλα context windows πρέπει να διαχειρίζονται προσεκτικά. Τα σφάλματα περιλαμβάνουν 401 για μη έγκυρα κλειδιά, 402 για ανεπαρκές υπόλοιπο και 429 για όρια ρυθμού.

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