Τεκμηρίωση API για προγραμματιστές

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

Συνδεθείτε στην υποδομή μας κατευθύνοντας τον πελάτη σας στη designated βάση URL και παρέχοντας το μοναδικό σας API key. Χρησιμοποιούμε τυπική πιστοποίηση κεφαλίδας ώστε να μπορείτε να ενσωματώσετε το endpoint μας σε υπάρχουσες διαμορφώσεις SDK του OpenAI χωρίς να ξαναγράψετε τον βασικό σας λογισμό. Λαμβάνετε ένα ενεργό κλειδί ανά λογαριασμό και η δημιουργία νέου κλειδιού ακυρώνει αμέσως το προηγούμενο. Αυτός ο σχεδιασμός διατηρεί την ενσωμάτωσή σας απλή διατηρώντας σαφή έλεγχο πρόσβασης. Εγγραφείτε μέσω Google ή email για να δείτε το κλειδί σας ακαριαία. Δεν απαιτούμε αριθμό τηλεφώνου ή μέθοδο πληρωμής για να ξεκινήσετε.

• Base URL: https://api.uncensoreai.com/v1
• Κεφαλίδα Auth: Authorization: Bearer YOUR_API_KEY

Πρώτη αίτηση (POST /v1/chat/completions)

Στείλτε την πρώτη ολοκλήρωση στέλνοντας ένα payload JSON στο endpoint ολοκληρώσεων συνομιλίας. Το ID μοντέλου είναι uncensored και δέχεται τυπικές δομές μηνυμάτων με ρόλους system, user, και assistant. Λαμβάνετε άμεση κειμενική έξοδο χωρίς πολύπλοκη διαδρομή ή λογική επιλογής μοντέλου. Τα σφάλματα δεν καταναλώνουν τα προπληρωμένα σας credits, οπότε μπορείτε να δοκιμάζετε ελεύθερα. Το μοντέλο διαχειρίζεται open-weight generation προσαρμοσμένο για ενήλικα περιεχόμενο χωρίς άρνηση. Χρησιμοποιήστε αυτή τη δομή για να ξεκινήσετε την ενσωμάτωσή σας.

Ενσωμάτωση SDK Python

Χρησιμοποιήστε το επίσημο Python client για να αλληλεπιδράσετε ομαλά με την API μας. Ορίστε το base URL και το API key στο αντικείμενο διαμόρφωσής σας πριν κάνετε κλήσεις. Η βιβλιοθήκη διαχειρίζεται τη σειριοποίηση JSON και την ανάλυση απαντήσεων για εσάς. Μπορείτε να αποκτήσετε πρόσβαση στα δεδομένα χρήσης απευθείας από το αντικείμενο απάντησης. Αυτή η προσέγγιση λειτουργεί με οποιοδήποτε τυπικό περιβάλλον Python που υποστηρίζει async ή sync αιτήματα. Διατηρήστε το key σας ασφαλές σε μεταβλητές περιβάλλοντος. Το δείγμα κώδικα παρουσιάζει μια βασική συγχρονισμένη κλήση.

Ενσωμάτωση SDK Node.js

Ενσωματώστε σε έργα Node.js χρησιμοποιώντας τον τυπικό διαχειριστή πακέτων. Εισάγετε τον πελάτη και ρυθμίστε τη βάση URL για να δείχνει στους διακομιστές μας. Το SDK διαχειρίζεται τα αιτήματα HTTP και παρέχει τυποποιημένες απαντήσεις για χρήστες TypeScript. Μπορείτε να προσθέσετε εύκολα κεφαλίδες ή να τροποποιήσετε χρονικά όρια αν χρειαστεί. Αυτή η μέθοδος ταιριάζει σε σύγχρονες εφαρμογές ιστού και υπηρεσίες backend. Βεβαιωθείτε ότι η έκδοση Node σας είναι συμβατή με τις απαιτήσεις του SDK. Το παρακάτω παράδειγμα δείχνει μια απλή αίτηση συμπλήρωσης.

Streaming Αποκρίσεις και Χρήση Token

Ενεργοποίηση εξόδου σε πραγματικό χρόνο ορίζοντας το stream flag to true στην αίτησή σας. Η API επιστρέφει Server-Sent Events (SSE) καθώς παράγονται tokens. Μπορείτε να εμφανίσετε κείμενο στους χρήστες άμεσα χωρίς να περιμένετε την πλήρη απόκριση. Οι λεπτομέρειες χρήσης tokens εμφανίζονται στο τελευταίο chunk του stream. Αυτή η λειτουργία μειώνει την αντιλαμβανόμενη καθυστέρηση για μεγάλες εξόδους. Παρακολουθήστε το υπόλοιπο πιστωτικού σας καθώς συσσωρεύονται tokens. Το streaming λειτουργεί με όλες τις τυπικές παραμέτρους όπως temperature και stop sequences.

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

Ο λογαριασμός σας έχει context window 100,000 tokens για prompt και completion συνδυαστικά. Μπορείτε να στείλετε έως 16,000 tokens σε μια μεμονωμένη απόκριση αν ορίσετε max_tokens. Το προεπιλεγμένο όριο εξόδου είναι 2.048 tokens αν παραλείψετε αυτή την παράμετρο. Τα όρια ρυθμού επιτρέπουν 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Ο κωδικός κατάστασης 401 σημαίνει ότι το κλειδί σας είναι άκυρο. Ο κωδικός 402 υποδεικνύει ανεπαρκές προπληρωμένο credit. Ο κωδικός 429 σημαίνει ότι έχετε ξεπεράσει το όριο ρυθμού. Τα σώματα αιτημάτων δεν μπορούν να υπερβαίνουν τα 8 MB.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

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