Uncensored AI API Quickstart

Προαπαιτούμενα και ρύθμιση base URL

Ξεκινήστε εγγεγραμμένοι σε έναν λογαριασμό μέσω Google ή email στη σελίδα κλειδιών. Το API key σας εμφανίζεται αμέσως και λειτουργεί ως το μοναδικό διαπιστευτήριο για όλες τις αιτήσεις. Η βάση URL της υπηρεσίας είναι https://api.uncensoredroleplayai.com/v1, το οποίο λειτουργεί με οποιοδήποτε OpenAI-compatible client.

Ρυθμίστε τη μεταβλητή περιβάλλοντος ή τον πελάτη SDK για να κατευθύνετε σε αυτό το URL. Αυτό το μοναδικό endpoint διαχειρίζεται όλες τις συμπληρώσεις κειμένου. Δεν χρειάζεται να διαχειριστείτε routing μοντέλων ή να επιλέξετε από πολλαπλούς προμηθευτές. Ο αναγνωριστικός κωδικός μοντέλου είναι πάντα uncensored, ένα μοντέλο ανοιχτού βάρους ρυθμισμένο για ενήλικα και φανταστικό περιεχόμενο.

Πιστοποίηση με API keys

Συμπεριλάβετε το API key στο Authorization header ως Bearer token. Κάθε αίτηση πρέπει να φέρνει αυτό το header για να πιστοποιήσει την ταυτότητά σας. Αν το key λείπει ή είναι άκυρο, ο διακομιστής επιστρέφει σφάλμα 401 Unauthorized. Ελέγξτε το dashboard του λογαριασμού σας αν υποψιάζεστε ότι το key ανακλήθηκε.

Κάθε λογαριασμός διαθέτει ένα ενεργό κλειδί τη φορά. Η δημιουργία νέου κλειδιού αντικαθιστά αμέσως το παλιό. Δεν υπάρχει όριο στον αριθμό των κλειδιών που μπορείτε να δημιουργήσετε ιστορικά, αλλά μόνο το τρέχον λειτουργεί. Χρησιμοποιήστε αυτό το μοναδικό κλειδί σε όλες τις υπηρεσίες σας.

Αποστολή της πρώτης σας ολοκλήρωσης συνομιλίας

Κάντε μια POST αίτηση στο /v1/chat/completions endpoint. Δώστε το όνομα του model uncensored και την ιστορία συνομιλίας σας στο messages array. Το σύστημα επιστρέφει μια απάντηση κειμένου χωρίς φιλτράρισμα για θέματα ενήλικων.

• Ορίστε το μοντέλο σε uncensored.
• Συμπεριλάβετε το system prompt για να ορίσετε το persona roleplay.
• Υποβάλετε μηνύματα χρήστη για να προωθήσετε την αφήγηση.

Επαληθεύστε ότι η δομή της απόκρισης περιέχει το generated text. Αυτό επιβεβαιώνει ότι η ενσωμάτωσή σας λειτουργεί σωστά με την uncensored LLM API.

Διαχείριση streaming αποκρίσεων

Ενεργοποιήστε streaming ρυθμίζοντας stream σε true στο αίτημά σας. Το API στέλνει chunks μέσω Server-Sent Events (SSE). Κάθε chunk περιέχει μερικό κείμενο και μεταδεδομένα. Επεξεργαστείτε αυτά τα chunks σε πραγματικό χρόνο για να εμφανίσετε την απάντηση καθώς παράγεται.

Τα λεπτομερή δεδομένα χρήσης token εμφανίζονται στο τελευταίο chunk. Αυτό σας επιτρέπει να παρακολουθείτε το κόστος με ακρίβεια χωρίς να περιμένετε την ολόκληρη απάντηση. Το streaming είναι ιδανικό για bots roleplay όπου η καθυστέρηση παίζει ρόλο. Χρησιμοποιήστε το Node SDK για εύκολη διαχείριση αυτών των γεγονότων.

Ρύθμιση παραμέτρων για roleplay

Προσαρμόστε παραμέτρους όπως temperature και top_p για τον έλεγχο της δημιουργικότητας. Οι υψηλότερες θερμοκρασίες παράγουν πιο ποικίλα και απρόβλεπτα αποτελέσματα. Χρησιμοποιήστε stop ακολουθίες για να τερματίσετε τις απαντήσεις σε συγκεκριμένες φράσεις. Ο JSON mode είναι διαθέσιμος μέσω response_format για δομημένα δεδομένα.

Ορίστε max_tokens για τον έλεγχο του μήκους εξόδου. Η προεπιλογή είναι 2.048 tokens, αλλά μπορείτε να ζητήσετε έως 16.000. Το παράθυρο συμφραζομένων υποστηρίζει 100.000 tokens συνολικά. Αυτό επιτρέπει τη συνέχεια μακροσκελούς κειμένου χωρίς απώλεια συμφραζομένων. Βελτιστοποιήστε αυτές τις ρυθμίσεις για την συγκεκριμένη περίπτωσή σας.

Κατανόηση της χρήσης και της τιμολόγησης tokens

Η τιμολόγηση είναι διαφανής: $0.15 ανά εκατομμύριο input tokens και $0.50 ανά εκατομμύριο output tokens. Τα σφάλματα και οι απορρίψεις είναι δωρεάν. Τα χρήματα είναι προπληρωμένα και λήγουν ποτέ. Ανεβάστε κεφάλαιο μέσω κρυπτονομισμάτων με USDT (TRC20) ή USDC (Base).

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

cURL

Copycurl https://api.uncensoredroleplayai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Ροή

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)