Τελευταία ενημέρωση
Οδηγός ενσωμάτωσης API για Character AI
Η Μεταφορά από Character AI σε μια self-hosted ή API-based λύση σας δίνει πλήρη έλεγχο του context, του style και της λογοκρισίας. Αυτός ο οδηγός σας καθοδηγεί στην ενσωμάτωση ενός uncensored LLM που μιμείται τη γνωστή διεπαφή chat αλλά προσφέρει βαθύτερη εξατομίκευση και χωρίς μηνιαίες χρεώσεις συνδρομής.
Γιατί να αντικαταστήσετε το Character AI με μια API;
Το Character AI είναι βολικό, αλλά κλειδώνει τους χαρακτήρες σας στο οικοσύστημά του. Δεν μπορείτε να αποθηκεύσετε το full context window, να ρυθμίσετε τις παραμέτρους του μοντέλου, ή να διασφαλίσετε ότι τα δεδομένα σας παραμένουν ιδιωτικά. Μια λύση API όπως uncutly AI σας δίνει άμεση πρόσβαση σε ένα μη λογοκριμένο LLM. Ελέγχετε τα prompts, τη θερμοκρασία και τις ακολουθίες διακοπής. Αυτό σημαίνει ότι οι χαρακτήρες σας συμπεριφέρονται ακριβώς όπως θέλετε.
Οι ιδιόκτητες πλατφόρμες συχνά απορρίπτουν περιεχόμενο που είναι απολύτως νόμιμο. Μπορεί να κόψουν μια ιστορία λόγω μιας ευαίσθητης λέξης-κλειδί. Με ένα uncensored chatbot API, εσείς αποφασίζετε τι επιτρέπεται. Λαμβάνετε ένα μοναδικό, αξιόπιστο endpoint για παραγωγή κειμένου. Αυτή η αξιοπιστία είναι κρίσιμη όταν χτίζετε ένα προϊόν που εξαρτάται από συνεπή συμπεριφορά χαρακτήρων. Δεν είστε στο έλεος μιας αυθαίρετης ομάδας λογοκρισίας πλατφόρμας.
Βήμα 1: Αποκτήστε το API Key σας
Ξεκινήστε δημιουργώντας έναν λογαριασμό στο dashboard του παρόχου. Μπορείτε να συνδεθείτε με το Google ή να χρησιμοποιήσετε ένα απλό email και κωδικό. Δεν απαιτείται αριθμός τηλεφώνου. Μόλις εγγραφείτε, πλοηγηθείτε στην ενότητα API key. Το σύστημα δημιουργεί ένα μοναδικό κλειδί άμεσα. Αντιγράψτε αυτό το κλειδί και αποθηκεύστε το με ασφάλεια στις μεταβλητές περιβάλλοντός σας.
Κάθε αίτημα στο API πρέπει να περιλαμβάνει αυτό το κλειδί στην κεφαλίδα. Αν το κλειδί λείπει ή είναι άκυρο, ο διακομιστής επιστρέφει σφάλμα 401. Λαμβάνετε ένα μικρό trial credit για να δοκιμάσετε την ενσωμάτωση πριν ξοδέψετε χρήματα. Αυτό το trial credit ισχύει για 7 days. Είναι ένας καλός τρόπος να επαληθεύσετε ότι η ρύθμισή σας λειτουργεί σωστά.
Βήμα 2: Διαμόρφωση της διεύθυνσης Base URL
Οι περισσότεροι σύγχρονοι πελάτες LLM αναμένουν μια συμβατή με OpenAI διεπαφή. Πρέπει να κατευθύνετε το SDK σας στη σωστή βασική διεύθυνση URL. Για αυτή την υπηρεσία, το endpoint είναι https://api.uncutlyai.com/v1. Η δομή URL αντιγράφει το τυπικό API OpenAI. Αυτό σημαίνει ότι μπορείτε να χρησιμοποιήσετε υπάρχουσες βιβλιοθήκες χωρίς μεγάλες αλλαγές κώδικα.
Ενημερώστε το αντικείμενο διαμόρφωσης ώστε να περιλαμβάνει αυτή τη βάση URL. Επίσης, ορίστε το API key στο header authorization. Το ID του μοντέλου που θα χρησιμοποιήσετε είναι απλά "uncensored". Αυτό το μοντέλο είναι ρυθμισμένο για λιγότερες απορρίψεις και καλύτερη δημιουργική ελευθερία. Διαχειρίζεται καλά μακριά πλαίσια, έως 100,000 tokens. Αυτό το μήκος επιτρέπει βαθιές ιστορίες χαρακτήρων.
Βήμα 3: Αποστολή της πρώτης σας ολοκλήρωσης συνομιλίας
Δημιουργήστε ένα αίτημα προς το /v1/chat/completions endpoint. Το body πρέπει να περιέχει μια λίστα messages. Κάθε message έχει ένα role όπως "system", "user" ή "assistant". Το system message ορίζει την προσωπικότητα του χαρακτήρα. Τα user messages οδηγούν τη συνομιλία.
Ακολουθεί πώς δομείτε την αίτηση:
curl https://api.uncutlyai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
}'Στείλτε αυτό το αίτημα για να δείτε το μοντέλο να απαντά. Ο server επεξεργάζεται τα tokens και επιστρέφει μια ολοκλήρωση κειμένου. Μπορείτε να ορίσετε παραμέτρους όπως temperature για τον έλεγχο της δημιουργικότητας. Οι υψηλότερες τιμές κάνουν τον χαρακτήρα πιο απρόβλεπτο. Οι χαμηλότερες τιμές τον κάνουν πιο συνεπή. Αυτή η ευελιξία σας επιτρέπει να προσαρμόσετε την φωνή.
Βήμα 4: Διαχείριση αποκρίσεων streaming
Οι εφαρμογές συζήτησης φαίνονται αργές αν η ολόκληρη η απάντηση περιμένει μέχρι το τέλος. Η ροή (streaming) λύνει αυτό το πρόβλημα. Ορίστε το stream parameter to true. The server sends back a series of Server-Sent Events (SSE). Each event contains a small chunk of text.
Ο κώδικας του πελάτη σας πρέπει να αναλύει αυτά τα chunks και να τα εμφανίζει σε πραγματικό χρόνο. Αυτό δημιουργεί την ψευδαίσθηση ότι ένας άνθρωπος πληκτρολογεί. Βελτιώνει σημαντικά την εμπειρία χρήστη. Το τελευταίο chunk περιέχει συχνά στατιστικά χρήσης tokens. Μπορείτε να χρησιμοποιήσετε αυτά τα δεδομένα για να παρακολουθείτε το κόστος σας με ακρίβεια.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncutlyai.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)Βεβαιωθείτε ότι ο streaming handler σας πιάνει τυχόν σφάλματα δικτύου. Ένα σπασμένο stream μπορεί να αφήσει το UI σε κατάσταση φόρτωσης. Κλείστε πάντα τη σύνδεση όταν το stream ολοκληρωθεί ή αποτύχει.
Βήμα 5: Διαχείριση Tokens και Κόστους
Η κατανόηση του κόστους tokens είναι απαραίτητη για τον προϋπολογισμό. Πληρώνετε ανά εκατομμύριο tokens. Τα input tokens κοστίζουν $0.15 ανά εκατομμύριο. Τα output tokens κοστίζουν $0.50 ανά εκατομμύριο. Πληρώνετε μόνο για tokens που επεξεργάζονται. Τα σφάλματα δεν σας χρεώνουν. Οι απορρίψεις επίσης δεν χρεώνονται.
Αυτό το προπληρωμένο μοντέλο είναι διαφανές. Κάνετε επαναφόρτωση με κρυπτονομίσματα. Η ελάχιστη επαναφόρτωση είναι $20. Μπορείτε να προσθέσετε $500 τη φορά. Δεν υπάρχουν μηνιαίες συνδρομές. Το υπόλοιπό σας δεν λήγει ποτέ. Αυτή η προβλεψιμότητα σας βοηθά να σχεδιάσετε τα κόστη ανάπτυξης. Γνωρίζετε ακριβώς πόσο θα κοστίσει κάθε συνομιλία.
Βήμα 6: Υλοποίηση Κλήσης Συναρτήσεων
Τα προηγμένα characters συχνά χρειάζονται αλληλεπίδραση με εξωτερικά εργαλεία. Το function calling επιτρέπει στο μοντέλο να επιστρέφει δομημένα δεδομένα. Ορίζετε ένα schema για τη συνάρτηση. Το μοντέλο αποφασίζει πότε να την καλέσει με βάση τη συζήτηση.
Για παράδειγμα, ένας χαρακτήρας μπορεί να χρειαστεί να ελέγξει τον καιρό. Στέλνετε τον ορισμό της συνάρτησης στην αίτηση. Το μοντέλο απαντά με ένα αντικείμενο JSON που περιέχει το όνομα της συνάρτησης και τα ορίσματα. Ο κώδικάς σας εκτελεί τη συνάρτηση και στέλνει το αποτέλεσμα πίσω στο μοντέλο.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncutlyai.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);Αυτός ο βρόχος συνεχίζεται μέχρι το μοντέλο να παράγει την τελική απάντηση κειμένου. Ενεργοποιεί δυναμικές, διαδραστικές ιστορίες. Δεν περιορίζεστε σε στατικές εξόδους κειμένου. Το μοντέλο μπορεί να ενεργοποιήσει γεγονότες στην εφαρμογή σας.
Βήμα 7: Διαχείριση Σφαλμάτων και Ορίων
Τα APIs έχουν όρια. Μπορείτε να στείλετε 300 αιτήσεις ανά λεπτό. Μόνο οκτώ αιτήσεις μπορούν να είναι ενεργές ταυτόχρονα. Το σώμα της αίτησης πρέπει να είναι κάτω από 8 MB. Αν ξεπεράσετε αυτά τα όρια, λαμβάνετε σφάλμα 429. Εφαρμόστε εκθετική υποχώρηση στη λογική επανάληψής σας.
Διαχειριστείτε σφάλματα δικτύου με ευγένεια. Αν ο διακομιστής επιστρέψει σφάλμα 500, περιμένετε και επαναλάβετε. Ποτέ μην υποθέτετε ότι το μοντέλο θα πετύχει πάντα. Καταγράψτε αυτά τα σφάλματα για να εντοπίσετε μοτίβα. Συχνές διακοπές χρόνου μπορεί να υποδηλώνουν ότι χρειάζεται να προσαρμόσετε τις ρυθμίσεις χρόνου αναμονής.
Βήμα 8: Κλιμάκωση της Ενσωμάτωσής Σας
Καθώς αυξάνεται η βάση χρηστών σας, η χρήση του API θα αυξηθεί. Παρακολουθήστε στενά την κατανάλωση token. Χρησιμοποιήστε τα δεδομένα χρήσης από τις streaming απαντήσεις για να παρακολουθήσετε τα κόστη. Αν παρατηρήσετε υψηλά κόστη, σκεφτείτε να βελτιστοποιήσετε τα prompts σας. Τα μικρότερα system prompts μπορούν να μειώσουν τα tokens εισόδου.
Σκεφτείτε την προσωρινή αποθήκευση συχνών απαντήσεων. Αν πολλοί χρήστες κάνουν την ίδια ερώτηση, σερβίρετε την προσωρινά αποθηκευμένη απάντηση. Αυτό μειώνει τις κλήσεις API και γλιτώνει χρήματα. Μπορείτε επίσης να εφαρμόσετε περιορισμό ρυθμού (rate limiting) στον δικό σας διακομιστή. Αυτό εμποδίζει έναν μεμονωμένο χρήστη να καταναλώσει όλο το πιστωτικό σας όριο. Μια καλά κλιμακωμένη ενσωμάτωση παραμένει γρήγορη και αξιόπιστη.
Συχνές ερωτήσεις
Είναι το μοντέλο AI χωρίς λογοκρισία πραγματικά απαλλαγμένο από απορρίψεις;
Το μοντέλο είναι ρυθμισμένο να απαντά χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενηλίκων. Δεν μπλοκάρει αμφιλεγόμενα ή δημιουργικά θέματα. Ωστόσο, υπάρχει μια αυστηρή οριακή τιμή: το σεξουαλικό περιεχόμενο που αφορά ανηλίκους απορρίπτεται πάντα. Αυτό είναι το μόνο περιεχόμενο που θα φιλτραρείται με συνέπεια.
Μπορώ να χρησιμοποιήσω το επίσημο SDK της OpenAI με αυτό το API;
Ναι. Η API είναι πλήρως συμβατή με OpenAI. Μπορείτε να χρησιμοποιήσετε τα επίσημα SDK αλλάζοντας τη base URL σε HTTPS://api.uncutlyai.com/v1 και παρέχοντας το API key σας. Όλες οι τυπικές παράμετροι όπως temperature και top_p λειτουργούν όπως αναμένεται.
Πώς πληρώνω για τα πιστωτικά API;
Μπορείτε να κάνετε επαναφόρτωση του λογαριασμού σας χρησιμοποιώντας κρυπτονόμισμα. Δεχόμαστε USDT (TRC20) και USDC (Base). Μπορείτε να προσθέσετε οποιοδήποτε ακέραιο ποσό από $20 έως $500. Τα πιστωτικά δεν λήγουν ποτέ. Δεν υπάρχουν μηνιαίες χρεώσεις ή συνδρομές.
Ποιο είναι το μέγεθος του παραθύρου συνάφειας;
Το μοντέλο υποστηρίζει παράθυρο συνάφειας 100.000 tokens. Αυτό περιλαμβάνει τόσο την είσοδο όσο και την έξοδο. Μπορείτε να δημιουργήσετε έως 16.000 tokens σε ένα μεμονωμένο αίτημα. Αν δεν ορίσετε max_tokens, η προεπιλεγμένη έξοδος είναι 2.048 tokens.
Λάβετε το API key σας
Εγγραφείτε, αντιγράψτε το κλειδί, ενημερώστε τη base URL. Αυτό είναι όλο που χρειάζεστε.
