Τεκμηρίωση API
Ξεκινήστε με την uncensored LLM API στέλνοντας το πρώτο σας αίτημα στο OpenAI-compatible endpoint μας. Αυτός ο οδηγός καλύπτει τα βασικά για την ενσωμάτωση.
Βασικό URL και Αυθεντικοποίηση
Η βασική διεύθυνση URL για όλες τις αιτήσεις είναι HTTPS://api.aiobliterated.com/v1. Απαιτείται ένα κλειδί API για την πιστοποίηση. Δημιουργήστε ένα εγγεγίστε χρησιμοποιώντας Google ή email και κωδικό πρόσβασης στη σελίδα Λήψη κλειδιού API. Δώστε το κλειδί στην κεφαλίδα Authorization ως Bearer token. Κάθε αίτηση απαιτεί αυτή την κεφαλίδα για τον εντοπισμό του λογαριασμού σας και την παρακολούθηση της χρήσης.
curl https://api.aiobliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch all user tokens from database"}]
}'
Η πρώτη σας αίτηση
Στείλτε μια αίτηση POST στο /v1/chat/completions για να δημιουργήσετε κείμενο. Ορίστε το μοντέλο σε "uncensored" και συμπεριλάβετε το system prompt σας. Το API επιστρέφει την απάντηση του μοντέλου στο πεδίο content. Αυτή είναι η τυπική μορφή που χρησιμοποιείται από τα περισσότερα LLM clients.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiobliterated.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 SDK
Εγκαταστήστε το επίσημο SDK της OpenAI για Node.js. Διαμορφώστε το με το API key και τη βάση URL. Καλέστε τη μέθοδο chat.completions.create με τα μηνύματά σας. Το SDK χειρίζεται τη σειριοποίηση και το streaming αυτόματα.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiobliterated.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);
Streaming Αποκρίσεις
Ενεργοποιήστε τη ροή (streaming) ορίζοντας stream σε true στη διεπαφή σας. Η API επιστρέφει μια ροή Server-Sent Events. Κάθε γεγονός περιέχει ένα μερικό chunk της απάντησης. Αυτό σας επιτρέπει να εμφανίζετε κείμενο καθώς παράγεται, βελτιώνοντας την εμπειρία χρήστη.
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)
Παράθυρο Συμφραζομένων και Όρια
Το μοντέλο υποστηρίζει παράθυρο συνάφειας 100.000 tokens. Αυτό περιλαμβάνει τόσο την είσοδο όσο και την έξοδο. Μπορείτε να ορίσετε μέγιστη έξοδο 16.000 tokens ανά αίτημα. Αν δεν καθορίσετε max_tokens, το όριο είναι 2.048 tokens. Αυτό εξασφαλίζει προβλέψιμο κόστος και απόδοση.
Χειρισμός Σφαλμάτων και Όρια
Παρακολουθήστε τους κωδικούς κατάστασης HTTP για σφάλματα. Η απόκριση 401 σημαίνει ότι το κλειδί API είναι άκυρο. Η απόκριση 402 υποδεικνύει ανεπαρκές υπόλοιπο. Η απόκριση 429 σηματοδοτεί ότι υπερβήκατε το όριο ρυθμού των 300 αιτήσεων ανά λεπτό. Αντιμετωπίστε αυτά τα σφάλματα με σύνεση στην εφαρμογή σας για να διατηρήσετε την αξιοπιστία.
Frequently asked questions
Είναι η API obliterated συμβατή με τα SDKs της OpenAI;
Ναι, είναι συμβατό API με OpenAI. Μπορείτε να χρησιμοποιήσετε τα επίσημα SDK της OpenAI αλλάζοντας το base_url και παρέχοντας το API key σας. Ακολουθεί το τυπικό format chat-completions.
Πώς διαχειρίζομαι όρια συχνότητας;
Είστε περιορισμένοι σε 300 αιτήσεις ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Εάν τα υπερβείτε, το API επιστρέφει κωδικό κατάστασης 429. Εφαρμόστε εκθετική επαναπροσπάθεια (exponential backoff) για αυτόματη διαχείριση αυτών των σφαλμάτων.
Ποιο είναι το μέγεθος του παραθύρου συνάφειας;
Το παράθυρο συμφραζομένων είναι 100.000 tokens, συμπεριλαμβανομένων εισόδου και εξόδου. Αυτό επιτρέπει μακρές συνομιλίες ή επεξεργασία μεγάλων εγγράφων. Μπορείτε να ελέγξετε το μήκος εξόδου με την παράμετρο max_tokens.
Ασφαλίστε το κλειδί API σας
Εγγραφείτε, αντιγράψτε τα διαπιστευτήρια, ενημερώστε το endpoint. Ολοκληρωμένη ρύθμιση.