Οδηγός Ενσωμάτωσης: API Chat Completions

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

Η API του abliterated λειτουργεί ως άμεση αντικατάσταση των τυπικών σημείων τερματισμού της OpenAI. Στέλνετε αιτήματα σε https://api.aiabliterated.cc/v1 and authenticate using a Bearer token in the Authorization header. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε client που υποστηρίζει το πρωτόκολλο OpenAI.

• Base URL: https://api.aiabliterated.cc/v1
• Κεφαλίδα Auth: Authorization: Bearer YOUR_API_KEY
• ID Μοντέλου: uncensored

Η πιστοποίηση είναι αυστηρή. Αν στείλετε μη έγκυρο κλειδί, το σύστημα επιστρέφει αμέσως σφάλμα 401.

Το Endpoint /v1/chat/completions

Στείλτε τα δεδομένα prompt σας στο /v1/chat/completions σημείο τερματισμού (endpoint) για λήψη απαντήσεων κειμένου. Το σύστημα αναμένει ένα φορτίο JSON που περιέχει τον αναγνωριστικό μοντέλου και την ιστορία μηνυμάτων σας. Αυτή είναι μια διεπαφή μόνο κειμένου· μην αναμένετε παραγωγή εικόνας ή ήχου.

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

Copyfrom openai import OpenAI

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

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

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

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

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)

Function Calling και JSON Mode

Το μοντέλο abliterated υποστηρίζει δομημένες εξόδους μέσω του response_format parameter. Ορίστε αυτό σε {"type": "json_object"} για να επιβληθεί αυστηρή συμμόρφωση με JSON. Αυτό είναι απαραίτητο για αξιόπιστη ενσωμάτωση με συστήματα backend.

Η κλήση συναρτήσεων είναι επίσης διαθέσιμη. Ορίστε εργαλεία στο αίτημά σας, και το μοντέλο θα εξάγει έγκυρο JSON που ταιριάζει με το σχήμα σας. Το σύστημα δεν επαληθεύει τους ορισμούς των εργαλείων σας, οπότε βεβαιωθείτε ότι τα σχήματά σας είναι σωστά πριν στείλετε αιτήματα. Αυτή η δυνατότητα επιτρέπει πολύπλοκες αρχιτεκτονικές agent χωρίς εξωτερικά στρώματα parsing.

Copyimport OpenAI from "openai";

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

Παράμετροι: Θερμοκρασία, Top-P, και Seed

Ελέγξτε την τυχαιότητα των εξόδων σας χρησιμοποιώντας τυπικές παραμέτρους δειγματοληψίας. Το temperature value ρυθμίζει τη δημιουργικότητα, ενώ top_p περιορίζει τη δειγματοληψία πυρήνα (nucleus sampling). Χρησιμοποιήστε seed για ντετερμινιστικά αποτελέσματα όταν χρειάζεστε αναπαραγώγιμα αποτελέσματα για debugging.

Άλλες διαθέσιμες παράμετροι περιλαμβάνουν stop ακολουθίες, presence_penalty, και frequency_penalty. Αυτές επιτρέπουν λεπτομερή έλεγχο της επανάληψης tokens και της τήρησης θέματος. Το uncensored μοντέλο ανταποκρίνεται καλά σε ρυθμίσεις χαμηλής θερμοκρασίας για παραγωγή κώδικα και σε υψηλές θερμοκρασίες για δημιουργικό γραπτό λόγο.

Όρια Ρυθμού και Περιορισμοί

Η API επιβάλλει αυστηρά όρια για να διασφαλιστεί η σταθερότητα για όλους τους χρήστες. Περιορίζεστε στις 300 αιτήσεις ανά λεπτό ανά κλειδί. Οι ταυτόχρονες αιτήσεις περιορίζονται στις 8 ταυτόχρονα. Κάθε σώμα αιτήματος δεν πρέπει να υπερβαίνει τα 8 MB.

Αν ξεπεράσετε αυτά τα όρια, το σύστημα επιστρέφει σφάλμα 429 Too Many Requests. Η χρέωση βασίζεται στην πραγματική χρήση tokens. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν το προκαταβλεπόμενο πιστωτικό σας υπόλοιπο. Μπορείτε να διαχειριστείτε το κλειδί σας απευθείας από το dashboard αν χρειαστεί να ανανεώσετε τα διαπιστευτήρια λόγω αυτών των περιορισμών.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'