Τεκμηρίωση API
Εισάγετε το uncensored model στον υπάρχοντα κώδικά σας με μηδενικό κόστος διαμόρφωσης. Αυτός ο οδηγός καλύπτει τα OpenAI-compatible endpoints, την πιστοποίηση και τη ρύθμιση streaming για άμεση ενσωμάτωση.
Γρήγορη Έναρξη: Ενσωμάτωση Python
Το πρώτο βήμα είναι η εγκατάσταση του επίσημου OpenAI SDK και η διαμόρφωση του base URL. Αυτό διασφαλίζει ότι το client σας κατευθύνει αιτήσεις στο uncensored LLM endpoint μας χωρίς να τροποποιήσει την υπάρχουσα λογική σας.
- Εγκαταστήστε το πακέτο μέσω pip.
- Ορίστε το κλειδί API και το βασικό URL.
- Στείλτε μια τυπική αίτηση ολοκλήρωσης συνομιλίας.
Αυτή η ρύθμιση λειτουργεί τόσο για τοπικά scripts όσο και για production servers.
Authentication and Base URL
Το κλειδί API σας πιστοποιεί κάθε αίτημα προς τη βασική διεύθυνση HTTPS://api.chatbotsemfiltro.com/v1. Το κλειδί δημιουργείται άμεσα κατά την εγγραφή και παραμένει έγκυρο έως ότου το ανακαλέσετε.
Αποθηκεύστε το κλειδί σε μια μεταβλητή περιβάλλοντος για να αποφύγετε την hard-coding μυστικών. Το SDK χειρίζεται αυτόματα την έγχυση header.
Τερματικό Συμπληρώματος Συζήτησης
Η βασική διεπαφή δέχεται αιτήματα POST στο /v1/chat/completions. Αναμένει ένα σώμα JSON με μηνύματα και παραμέτρους μοντέλου.
- Ορίστε τον ρόλο (system, user, assistant).
- Προσδιορίστε το μοντέλο ως "uncensored".
- Λάβετε κείμενο εξόδου.
Αυτή η δομή μιμείται το τυπικό format OpenAI, διασφαλίζοντας συμβατότητα.
Ροή δεδομένων και Κλήση Συναρτήσεων
Ενεργοποιήστε τη ροή (streaming) ορίζοντας stream σε true. Η API επιστρέφει chunks Server-Sent Events (SSE), παραδίδοντας tokens καθώς παράγονται.
Η κλήση συναρτήσεων υποστηρίζεται μέσω της παραμέτρου tools. Το μοντέλο επιστρέφει κλήσεις εργαλείων σε μορφή JSON, τις οποίες μπορείτε να αναλύσετε και να εκτελέσετε.
Παράμετροι: Θερμοκρασία και Top P
Προσαρμόστε θερμοκρασία για δημιουργικότητα ή ντετερμινισμό. Τιμές μεταξύ 0 και 2 ελέγχουν την τυχαιότητα. Το Top P φιλτράρει λέξεις βάσει αθροιστικής πιθανότητας.
Συνδυάστε αυτές τις παραμέτρους για να βελτιστοποιήσετε το στυλ εξόδου. Χρησιμοποιήστε seed για αναπαραγώγιμα αποτελέσματα κατά τη διάρκεια δοκιμών.
Παράθυρο Συμφραζομένων και Όρια
Το μοντέλο υποστηρίζει παράθυρο συνάφειας 100.000 tokens. Μέγιστη έξοδος 16.000 tokens ανά αίτημα.
Τα όρια ρυθμού είναι 300 αιτήματα ανά λεπτό. Η υπέρβαση αυτού του ορίου προκαλεί σφάλμα 429. Διαχειριστείτε την ταυτόχρονη πρόσβαση για να αποφύγετε την επιβράδυνση.
Χειρισμός Σφαλμάτων και Tokens
Διαχειριστείτε ομαλά τα σφάλματα HTTP. Το 401 υποδεικνύει μη έγκυρο key. Το 402 σημαίνει ανεπαρκά credit. Το 429 σηματοδοτεί περιορισμό ρυθμού.
Η χρήση token χρεώνεται ακριβώς. Τα σφάλματα δεν καταναλώνουν υπόλοιπο. Παρακολουθήστε τη χρήση μέσω του πίνακα ελέγχου.
cURL
curl https://api.chatbotsemfiltro.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top ten libraries for Rust async programming"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotsemfiltro.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotsemfiltro.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);Ροή
stream = 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)Συχνές ερωτήσεις
Αυτή είναι μια επίσημη API OpenAI;
Όχι. Πρόκειται για API συμβατό με OpenAI που εξυπηρετεί ένα ξεχωριστό μοντέλο χωρίς λογοκρισία. Χρησιμοποιήστε το ίδιο SDK, αλλά το model id και η βάση URL διαφέρουν.
Πώς διαχειρίζομαι σφάλματα streaming;
Ελέγξτε τον τύπο συμβάντος SSE. Αν είναι συμβάν σφάλματος, αναλύστε το μήνυμα και διαχειριστείτε το χωρίς κατανάλωση tokens.
Τι συμβαίνει αν ξεπεράσω το όριο ρυθμού;
Η API επιστρέφει κωδικό κατάστασης 429. Περιμένετε και κάντε επανάληψη με εκθετική υποχώρηση για να αποφύγετε επαναλαμβανόμενες αποτυχίες.
Λάβετε το API key σας άμεσα
Εγγραφείτε, αποκτήστε το κλειδί σας και ενημερώστε τη βάση URL. Αυτή είναι η πλήρης διαμόρφωση.