Γρήγορη Έναρξη: Ενσωματώστε το Uncensored API

Προαπαιτούμενα: SDK και Ρύθμιση Περιβάλλοντος

Εγκαταστήστε το επίσημο SDK για τη γλώσσα σας. Υποστηρίζουμε οποιοδήποτε openai compatible client. Our service acts as a drop-in replacement for standard OpenAI integrations.

Ορίστε τη μεταβλητή περιβάλλοντος σας αμέσως. Αυτό αποφεύγει την σκληρή κωδικοποίηση (hardcoding) των διαπιστευτηρίων στα αρχεία πηγαίου κώδικα. Το API key σας ταυτοποιεί τον λογαριασμό σας και παρακολουθεί τη χρήση.

Χρησιμοποιήστε την έκδοση της τυπικής βιβλιοθήκης. Οι περισσότεροι προγραμματιστές έχουν ήδη εγκατεστημένα αυτά τα πακέτα. Αν όχι, προσθέστε το πακέτο στις εξαρτήσεις σας.

Πιστοποίηση: Ρύθμιση του API Key

Περνάτε το κλειδί σας μέσω της Authorization header. Απαιτούμε Bearer token για κάθε αίτημα. Αυτή η μέθοδος είναι τυπική σε όλα τα OpenAI-compatible endpoints.

Δημιουργήστε το key σας από το dashboard. Λαμβάνετε ένα ενεργό key ανά λογαριασμό. Η αντικατάστασή του ακυρώνει το προηγούμενο άμεσα.

Κρατήστε το κλειδί σας ασφαλές. Μην το εκθέτετε σε κώδικα client-side. Το endpoint μας επαληθεύει τα διαπιστευτήρια πριν επεξεργαστεί tokens.

Τερματικό σημείο: POST /v1/chat/completions

Στείλτε το prompt σας στο endpoint συνομιλίας. Χρησιμοποιήστε το model field ορισμένο σε uncensored. Αυτό εξασφαλίζει ότι το αίτημα κατευθύνεται στο συγκεκριμένο μοντέλο μας.

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

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

Επεξεργαστείτε τη μορφή Server-Sent Events. Κάθε κομμάτι περιέχει μερικό κείμενο. Αθροίστε αυτά τα κομμάτια για να ανακατασκευάσετε την πλήρη απάντηση.

Παρακολουθήστε τη χρήση tokens στο τελευταίο chunk. Το τελευταίο event περιλαμβάνει τα πλήρη στατιστικά χρήσης. Αυτό βοηθά στην ακριβή παρακολούθηση των κόστων.

Function Calling και Χρήση Εργαλείων

Ορίστε εργαλεία στο σώμα του αιτήματος. Το μοντέλο επιστρέφει δομημένα ορίσματα. Ερμηνεύστε αυτά τα ορίσματα στη λογική της εφαρμογής σας.

Υποστηρίζει τυπικούς ορισμούς εργαλείων. Χρησιμοποιήστε tool_choice για να επιβληθεί συγκεκριμένη συμπεριφορά. Αυτό λειτουργεί με οποιοδήποτε OpenAI-compatible SDK.

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

Λειτουργία JSON και Δομημένες Εξόδους

Ορίστε response_format για json_object. Το μοντέλο επιστρέφει αυστηρά μορφοποιημένο JSON. Αυτό εξαλείφει σφάλματα ανάλυσης για δομημένα δεδομένα.

Ορίστε το schema σας καθαρά. Το μοντέλο ακολουθεί τις οδηγίες σας με ακρίβεια. Χρησιμοποιήστε το για εξαγωγή δεδομένων ή δημιουργία διαμόρφωσης.

Διαχειριστείτε σφάλματα ανάλυσης JSON. Ανεπαρκείς δομές εμφανίζονται ακόμη και περιστασιακά. Εφαρμόστε λογική fallback για ισχυρές εφαρμογές.

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

Διαχειριστείτε κατάλληλα τους κωδικούς κατάστασης HTTP. Ένα 401 σφάλμα σημαίνει ότι το κλειδί σας είναι άκυρο. Ένα 402 σφάλμα υποδεικνύει ανεπαρκές υπόλοιπο. Ένα 429 σφάλμα υποδεικνύει περιορισμό ρυθμού.

Σεβαστείτε το όριο των 300 αιτήσεων ανά λεπτό. Μπορείτε να στείλετε 8 ταυτόχρονες αιτήσεις. Η υπέρβαση αυτών των ορίων επιστρέφει σφάλμα 429. Περιμένετε πριν κάνετε επανάληψη.

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

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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