Developer Documentation

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

Το API key σας ταυτοποιεί κάθε αίτηση προς την chat-completions endpoint. Λαμβάνετε αυτό το κλειδί αμέσως μετά την εγγραφή σας μέσω Google ή email στο Get API key σελίδα. Δεν απαιτείται αριθμός τηλεφώνου. Αποθηκεύστε το κλειδί σας με ασφάλεια και περάστε το στο Authorization header.

Base URL: https://api.cheapllm.cc/v1. Όλες οι αιτήσεις πρέπει να περιλαμβάνουν αυτό το header: Authorization: Bearer YOUR_API_KEY. Τα σφάλματα τύπου 401 υποδηλώνουν λανθασμένο ή λείπον κλειδί. Αντικαταστήστε το παλιό κλειδί οποιαδήποτε στιγμή για να δημιουργήσετε ένα νέο; υπάρχει μόνο ένα ενεργό κλειδί ανά λογαριασμό.

Πρώτη αίτηση

Στείλτε το πρώτο prompt χρησιμοποιώντας το τυπικό chat/completions endpoint. Το model ID είναι uncensored. Αυτό το μοντέλο ανοιχτού βάρους απαντά χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση για ενήλικες, συμπεριλαμβανομένων φανταστικών ή αμφιλεγόμενων θεμάτων. Έχετε είσοδο κειμένου, έξοδο κειμένου. Δεν υπάρχουν εδώ embeddings ή παραγωγή εικόνων.

Παρακάτω ακολουθεί ένα βασικό παράδειγμα cURL. Αντικαταστήστε YOUR_API_KEY με το key σας. Το body της αίτησης ορίζει το μήνυμα του χρήστη. Επεξεργαζόμαστε 100,000 tokens context window (prompt + completion). Τα σφάλματα και οι απορρίψεις είναι δωρεάν, οπότε δοκιμάστε ελεύθερα.

• Ορίστε model για uncensored.
• Συμπεριλάβετε messages array.
• Προσθέστε τον τίτλο API key σας.

Copycurl https://api.cheapllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set timezone to UTC for all logs"}]
  }'

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

Χρησιμοποιήστε το επίσημο OpenAI Python SDK για να αλληλεπιδράσετε με την API μας. Ορίστε το base URL στο τερματικό σημείο μας και παρέχετε το key σας. Αυτή η προσέγγιση λειτουργεί με οποιαδήποτε βιβλιοθήκη πελάτη συμβατή με OpenAI. Διαμορφώστε παραμέτρους όπως temperature και top_p όπως χρειάζεται. Υποστηρίζεται streaming μέσω Server-Sent Events (SSE). Αυτή η μέθοδος είναι ιδανική για πραγματικού χρόνου εφαρμογές όπου θέλετε να εμφανίζετε tokens καθώς παράγονται.

Εγκαταστήστε τη βιβλιοθήκη με pip install openai. Αρχικοποιήστε τον πελάτη με τη βάση URL μας. Ο παρακάτω κώδικας δείχνει μια απλή αίτηση συμπλήρωσης. Προσαρμόστε το περιεχόμενο του μηνύματος για να ταιριάζει στην περίπτωσή σας. Το API μας διαχειρίζεται την ανακατεύθυνση προς το σωστό μοντέλο εσωτερικά.

Copyfrom openai import OpenAI

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

Node SDK Integration

Για προγραμματιστές Node.js, το πακέτο npm OpenAI λειτουργεί ομαλά. Ορίστε το base URL στο endpoint του API μας. Αυτό σας επιτρέπει να χρησιμοποιείτε γνωστά patterns από άλλους παρόχους. Ρυθμίστε το model ID σε uncensored. Μπορείτε επίσης να ενεργοποιήσετε τη λειτουργία JSON ή το function calling αν η εφαρμογή σας απαιτεί δομημένη έξοδο. Το SDK χειρίζεται αυτόματα τον έλεγχο ταυτότητας όταν διαμορφωθεί σωστά.

Εγκαταστήστε το πακέτο με npm install openaimax_tokens για τον έλεγχο του μήκους εξόδου. Τα σφάλματα επιστρέφονται ως τυπικοί κωδικοί κατάστασης HTTP. Χρησιμοποιήστε το για γρήγορη πρωτότυπη ανάπτυξη ή ενσωματώσεις παραγωγής.

Copyimport OpenAI from "openai";

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

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

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

Διαχειριστείτε τα γεγονότα της ροής στον κώδικα του πελάτη. Κλείστε τη σύνδεση όταν η ροή ολοκληρωθεί. Το API μας υποστηρίζει έως 8 ταυτόχρονες αιτήσεις ανά κλειδί. Αυτό το όριο διασφαλίζει δίκαιη χρήση. Παρακολουθήστε τη χρήση σας μέσω των δεδομένων του τελευταίου τμήματος. Τα σφάλματα κατά τη ροή επιστρέφουν ακόμη κατάλληλους κωδικούς κατάστασης. Χρησιμοποιήστε το για σενάρια roleplay ή συνεχούς συνομιλίας.

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)

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

Η API μας έχει αυστηρά όρια για διασφάλιση σταθερότητας. Μπορείτε να στείλετε 300 αιτήσεις ανά λεπτό ανά key. Οι ταυτόχρονες αιτήσεις περιορίζονται στις 8. Τα bodies αιτήσεων δεν μπορούν να υπερβαίνουν τα 8 MB. Το context window είναι 100.000 tokens συνολικά. Μέγιστη έξοδος 16.000 tokens ανά αίτημα (2.048 αν max_tokens είναι μη ρυθμισμένο). Τα σφάλματα επιστρέφουν συγκεκριμένους κωδικούς: 401 για μη έγκυρα κλειδιά, 402 για ανεπαρκή πιστωτικό υπόλοιπο και 429 για όρια ρυθμού. Το πιστωτικό υπόλοιπο δεν λήγει ποτέ. Λάθη όπως οι διπλές χρεώσεις διορθώνονται μέσω Υποστήριξης. Η ιδιωτικότητα διατηρείται· οι εντολές δεν χρησιμοποιούνται για εκπαίδευση. Δεν επιτρέπεται περιεχόμενο σεξουαλικού χαρακτήρα που αφορά ανηλίκους.