Τεκμηρίωση API: Chat Completions & Parameters

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

Συνδεθείτε στο API χρησιμοποιώντας τη βασική διεύθυνση URL που παρέχεται και το κλειδί API σας. Αυτή η διαδρομή λειτουργεί με τα τυπικά SDKs της OpenAI απλώς ενημερώνοντας τη διαμόρφωση. Λαμβάνετε ένα ενεργό κλειδί ανά λογαριασμό, το οποίο δημιουργείτε μέσω Google ή email κατά την εγγραφή. Το κλειδί ελέγχει την ταυτότητα κάθε αίτησης που κάνετε στην υπηρεσία.

Copycurl https://api.hubuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with user id and role"}]
  }'

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

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

Στείλτε τα δεδομένα prompt σας στο endpoint ολοκλήρωσης συνομιλίας για δημιουργία κειμένου. Αυτή είναι η βασική διεπαφή για τις εφαρμογές σας, χειριζόμενη όλη την είσοδο και έξοδο κειμένου. Πρέπει να καθορίσετε το μοντέλο ως 'uncensored' για να διασφαλίσετε συνεπή συμπεριφορά. Το API επεξεργάζεται το αίτημά σας και επιστρέφει την απαντητικό κείμενο.

Copyfrom openai import OpenAI

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

Σφάλματα όπως 401 υποδεικνύουν μη έγκυρο κλειδί, ενώ το 402 σημαίνει ότι χρειάζεστε περισσότερα πιστωτικά. Οι αιτήσεις χρεώνονται βάσει πραγματικής χρήσης tokens, οπότε τα σφάλματα δεν αδειάζουν το υπόλοιπό σας.

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

Λάβετε tokens σε πραγματικό χρόνο χρησιμοποιώντας Server-Sent Events (SSE). Αυτή η μέθοδος μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές εξόδους παραδίδοντας δεδομένα καθώς παράγονται. Μπορείτε να αναλύσετε το τελευταίο chunk για να λάβετε ακριβή στατιστικά στοιχεία χρήσης tokens για χρέωση. Το streaming είναι ιδανικό για διεπαφές προσανατολισμένες στον χρήστη όπου η άμεση ανατροφοδότηση έχει σημασία.

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)

Το παράθυρο πλαισίου (context window) επιτρέπει για 100,000 tokens συνολικά, συμπεριλαμβανομένου τόσο του prompt όσο και της ολοκλήρωσης. Η ροή (streaming) δεν αλλάζει τα όρια tokens ή τη δομή τιμολόγησης.

Function Calling και JSON Mode

Χρησιμοποιήστε κλήση συναρτήσεων για να ενσωματώσετε δομημένες εξόδους στη ροή εργασίας σας. Προσδιορίστε εργαλεία και tool_choice για να καθοδηγήσετε τη μορφή απόκρισης του μοντέλου. Μπορείτε επίσης να επιβάλετε αυστηρή λειτουργία JSON χρησιμοποιώντας την παράμετρο response_format για αξιόπιστη ανάλυση. Αυτό εξασφαλίζει ότι η εφαρμογή σας λαμβάνει δεδομένα στην ακριβή δομή που ορίζετε.

Copyimport OpenAI from "openai";

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

Αυτά τα features λειτουργούν εντός του single uncensored μοντέλου. Δεν υπάρχει model routing ή επιλογή μεταξύ διαφορετικών vendors. Εξαρτάστε από ένα open-weight μοντέλο tuned για unrestricted περιεχόμενο.

Παράμετροι: Temperature, Top P, και Stop

Ελέγξτε τη συμπεριφορά δημιουργίας με τυπικές παραμέτρους όπως temperature και top_p. Προσαρμόστε αυτές τις τιμές για να ισορροπήσετε τη δημιουργικότητα και τον ντετερμινισμό στις εξόδους σας. Η παράμετρος stop σας επιτρέπει να διακόψετε τη δημιουργία σε συγκεκριμένες αλληλουχίες. Μπορείτε επίσης να ορίσετε presence_penalty και frequency_penalty για να βελτιώσετε το στυλ εξόδου.

Ορίστε max_tokens σε 16.000 για μακρές απαντήσεις. Αν παραλείψετε το max_tokens, το default είναι 2.048 tokens ανά αίτηση. Αυτές οι ρυθμίσεις σας δίνουν ακριβή έλεγχο στη διαδικασία δημιουργίας.

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

Παρακολουθήστε τη χρήση σας έναντι αυστηρών ορίων ρυθμού για να διασφαλίσετε ομαλή λειτουργία. Επιτρέπονται 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το μέγιστο μέγεθος σώματος αιτήματος είναι 8 MB. Η υπέρβαση αυτών των ορίων επιστρέφει σφάλμα ορίου ρυθμού 429. Η κατανόηση αυτών των περιορισμών σας βοηθά να σχεδιάσετε ισχυρή λογική επανάληψης.

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