Τεκμηρίωση API

Authentication and Base URL

Η API απαιτεί ένα μόνο API key για πιστοποίηση. Λαμβάνετε αυτό το κλειδί άμεσα μετά την εγγραφή με Google ή διεύθυνση email. Περάστε το στο Authorization header ως Bearer token. Η βασική διεύθυνση URL είναι https://api.topuncensored.com/v1. Αυτό το URL λειτουργεί με οποιοδήποτε SDK ή βιβλιοθήκη πελάτη συμβατή με OpenAI.

• Χρησιμοποιήστε το header: Authorization: Bearer YOUR_API_KEY
• Ορίστε το base URL του πελάτη σας στο παρεχόμενο endpoint.

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

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

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

Στείλτε prompts κειμένου στο /v1/chat/completions endpoint. Το model ID είναι uncensored. Αυτό το endpoint διαχειρίζεται standard chat formatting με messages. Επιστρέφει text responses απευθείας. Δεν υπάρχουν επιπλέον layers ή wrappers. Ελέγχετε το context window των 100,000 tokens. Requests κάτω από 8 MB λειτουργούν αξιόπιστα. Χρησιμοποιήστε το για direct text generation.

Δομήστε το αίτημά σας με ένα prompt συστήματος και ένα μήνυμα χρήστη. Το μοντέλο απαντά χωρίς φιλτράρισμα νόμιμου περιεχομένου για ενήλικες. Σφάλματα όπως λείποντες κλειδιά επιστρέφουν 401. Μείνατε χωρίς πιστωτικό υπόλοιπο; Θα λάβετε σφάλμα 402. Αυτά είναι ξεκάθαρα σήματα.

Streaming Αποκρίσεις

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

Ανάλυση κάθε τμήματος για να χτίσετε την τελική σας απόκριση. Αυτή η μέθοδος χειρίζεται μεγάλες εξόδους με χάρη. Το API υποστηρίζει τυπικά Server-Sent Events. Αυτή είναι η συνιστώμενη προσέγγιση για διαδραστικές εφαρμογές.

Copyfrom openai import OpenAI

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

Κλήση Εργαλείων και Λειτουργία JSON

Χρησιμοποιήστε κλήση συναρτήσεων για δομημένες αλληλεπιδράσεις. Ορίστε τα εργαλεία στην αίτησή σας. Το μοντέλο επιστρέφει δομημένα ορίσματα. Ορίστε response_format για {"type": "json_object"} για αυστηρή έξοδο JSON. Αυτό διασφαλίζει προβλέψιμες μορφές δεδομένων. Συνδυάστε αυτά τα χαρακτηριστικά για ισχυρές ενσωματώσεις. Έχετε ακριβή έλεγχο της δομής της εξόδου.

Η κλήση εργαλείων λειτουργεί με το τυπικό schema OpenAI. Η λειτουργία JSON επιβάλλει έγκυρο JSON. Χρησιμοποιήστε αυτά για ολοκληρώσεις API ή εξαγωγή δεδομένων. Αυτή η ευελιξία υποστηρίζει σύνθετα workflows.

Copyimport OpenAI from "openai";

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

Παράμετροι και Όρια

Ρύθμιση temperature, top_p, και stop ακολουθίες. Ορίστε max_tokens σε 16.000. Προεπιλογή είναι 2.048 αν παραλειφθεί. Ελέγξτε την επανάληψη με presence_penalty και frequency_penalty. Χρησιμοποιήστε seed για ντετερμινιστικά αποτελέσματα. Αυτές οι παράμετροι βελτιστοποιούν την ποιότητα παραγωγής. Έχετε πλήρη έλεγχο πάνω στο στυλ εξόδου.

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

Σφάλματα και Παράθυρο Πλαισίου

Διαχειριστείτε τα σφάλματα με χάρη. Το 401 σημαίνει μη έγκυρο κλειδί. Το 402 υποδηλώνει ανεπαρκές υπόλοιπο. Το 429 σηματοδοτεί όρια ρυθμού. Το παράθυρο πλαισίου (context window) είναι 100.000 tokens συνολικά. Η μέγιστη έξοδος φτάνει τα 16.000 tokens. Διαχειριστείτε τα tokens σας με σύνεση. Τα σφάλματα δεν καταναλώνουν πιστωτικά μονάδες. Αυτό γλιτώνει χρήματα κατά την αποσφαλμάτωση. Χρησιμοποιήστε το τελευταίο τμήμα για στατιστικά χρήσης.

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

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)