Τεκμηρίωση API για Συμπληρώσεις Συνομιλίας Uncensored

Γρήγορη Έναρξη: Σύνδεση σε Python ή JavaScript

Συνδεθείτε στο API ενημερώνοντας τη βάση URL και ορίζοντας το API key σας. Το endpoint δέχεται τυπικά αιτήματα chat-completion και επιστρέφει κείμενο. Δεν χρειάζεται να εγκαταστήσετε εξειδικευμένες βιβλιοθήκες αν χρησιμοποιείτε τα επίσημα SDKs του OpenAI, καθώς η διεπαφή ταιριάζει ακριβώς με τις προδιαγραφές τους.

Ξεκινήστε με μια απλή αίτηση HTTP για να επαληθεύσετε τη συνδεσιμότητα. Χρησιμοποιήστε την εντολή curl παρακάτω για να στείλετε ένα βασικό prompt στο uncensored μοντέλο. Αντικαταστήστε YOUR_API_KEY με το κλειδί που δημιουργήθηκε στο dashboard σας.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Για προγραμματιστές Python, η διαδικασία είναι σχεδόν ταυτόσημη. Αρχικοποιήστε τον client με το key σας και το σωστό base URL. Αυτό διασφαλίζει ότι όλα τα αιτήματα διαδρομίζουν μέσω των uncensored servers μας διατηρώντας τη συμβατότητα με την υπάρχουσα tooling.

Copyfrom openai import OpenAI

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

Οι χρήστες JavaScript μπορούν να επιτύχουν το ίδιο αποτέλεσμα χρησιμοποιώντας το Node SDK. Ορίστε το baseURL property στο endpoint μας. Αυτή η προσέγγιση σας επιτρέπει να ενσωματώσετε το API σε web servers ή backend services με ελάχιστες αλλαγές κώδικα.

Copyimport OpenAI from "openai";

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

Πιστοποίηση και διαχείριση API Key

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

Δημιουργήστε το κλειδί σας στον πίνακα ελέγχου. Το κλειδί εμφανίζεται μία φορά κατά τη δημιουργία. Αποθηκεύστε το με ασφάλεια στις μεταβλητές περιβάλλοντος. Μην το κοινοποιείτε δημόσια. Κάθε λογαριασμός υποστηρίζει ένα ενεργό κλειδί τη φορά. Η δημιουργία νέου κλειδιού ακυρώνει το προηγούμενο άμεσα.

Χρησιμοποιήστε το key στις αιτήσεις σας ως εξής: Authorization: Bearer YOUR_API_KEY.Αυτή η τυπική μορφή κεφαλίδας λειτουργεί με όλα τα κύρια SDK. Κρατήστε το κλειδί σας κοντά για γρήγορη επανάληψη κατά την ανάπτυξη.

Παράμετροι τερματικού συμπληρώματος συζήτησης

Στείλτε αιτήματα στο /v1/chat/completions endpoint. Συμπεριλάβετε το messages array σας και ορίστε το model σε uncensored. Μπορείτε να προσαρμόσετε παραμέτρους όπως temperature και top_p για τον έλεγχο της δημιουργικότητας. Οι υψηλότερες τιμές παράγουν πιο ποικίλες απαντήσεις.

Ορίστε max_tokens για να περιορίσετε το μήκος της εξόδου. Η προεπιλογή είναι 2.048 tokens αν δεν οριστεί. Το μοντέλο υποστηρίζει παράθυρο συμφραζομένων 100.000 tokens για prompt συν συμπλήρωση. Αυτό επιτρέπει μακρές συνομιλίες χωρίς περικοπή. Προσαρμόστε presence_penalty και frequency_penalty για να μειώσετε την επανάληψη σε σενάρια role-play.

Χρησιμοποιήστε το stop παράμετρος για να διακόψει τη δημιουργία σε συγκεκριμένες φράσεις. Αυτό βοηθά στην επιβολή δομής διαλόγου. Το seed parameter διασφαλίζει reproducible εξόδους για testing. Αυτά τα εργαλεία σας δίνουν ακριβή έλεγχο στη συμπεριφορά του μοντέλου.

Οι ροές απαντήσεων (streaming) και τα δεδομένα χρήσης

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει κομμάτια κειμένου καθώς παράγονται. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες. Κάθε κομμάτι περιλαμβάνει μερικό κείμενο και μεταδεδομένα.

Τα δεδομένα χρήσης εμφανίζονται στο τελευταίο chunk. Αυτό περιλαμβάνει τον αριθμό tokens εισόδου και εξόδου. Ελέγξτε το usage field στην τελευταία αντικειμενική απάντηση. Αυτό επιτρέπει την ακριβή επαλήθευση χρέωσης χωρίς ξεχωριστά αιτήματα API. Παρακολουθήστε την κατανάλωση tokens σε πραγματικό χρόνο.

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

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)

Χειρισμός σφαλμάτων και όρια ρυθμού

Η API επιβάλλει όριο 300 αιτήσεων ανά λεπτό ανά key. Οι ταυτόχρονες αιτήσεις περιορίζονται στις οκτώ ανά key. Το σώμα αίτησης δεν πρέπει να υπερβαίνει τα 8 MB. Η υπέρβαση αυτών των ορίων επιστρέφει σφάλμα 429. Εφαρμόστε exponential backoff για να διαχειριστείτε τις παροδικές κορυφώσεις.

Συνηθισμένα σφάλματα περιλαμβάνουν 401 για μη έγκυρα κλειδιά και 402 για ανεπαρκές credit. Η απόκριση 402 υποδηλώνει ότι το προκαταβλημένο υπόλοιπό σας εξαντλήθηκε. Προσθέστε credit στο λογαριασμό σας για να συνεχίσετε την υπηρεσία. Τα σφάλματα δεν καταναλώνουν tokens, οπότε η επανάληψη μετά τη διόρθωση του προβλήματος είναι δωρεάν.

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

Οδηγός λειτουργίας JSON και κλήσης συναρτήσεων

Χρησιμοποιήστε JSON mode ρυθμίζοντας response_format για {"type": "json_object"}. Αυτό αναγκάζει το μοντέλο να εξάγει έγκυρο JSON. Ιδανικό για εξαγωγή δομημένων δεδομένων ή απαντήσεις API. Βεβαιωθείτε ότι η εντολή περιγράφει καθαρά το επιθυμητό σχήμα.

Η κλήση συναρτήσεων επιτρέπει στο μοντέλο να καλεί εργαλεία. Ορίστε τα εργαλεία στο σώμα του αιτήματος. Το μοντέλο επιστρέφει κλήσεις εργαλείου όταν είναι σκόπιμο. Διαχειριστείτε αυτές τις κλήσεις στη λογική της εφαρμογής σας. Αυτό επιτρέπει πολύπλοκες πολυβηματικές διαδικασίες.

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

Λεπτομέρειες μοντέλου και όρια παραθύρου συμφραζομένων

"Το uncensored το μοντέλο υποστηρίζει παράθυρο πλαισίου 100.000 tokens. Αυτό περιλαμβάνει τόσο το input prompt όσο και την output ολοκλήρωση. Μέγιστη έξοδος 16.000 tokens ανά αίτημα. Αυτό επιτρέπει εκτεταμένα σενάρια roleplay χωρίς διακοπή στη μέση της πρότασης.

Το μοντέλο είναι ανοιχτού βάρους (open-weight) και ρυθμισμένο για μη περιορισμένο περιεχόμενο. Δεν απορρίπτει νόμιμα θέματα ενηλίκων. Δεν είναι GPT, Claude ή οποιοδήποτε άλλο μοντέλο παρόχου. Οι αιτήσεις επεξεργάζονται στους εξειδικευμένους μας διακομιστές. Αυτό διασφαλίζει σταθερή απόδοση και χαμηλή καθυστέρηση (latency).

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