Ενσωμάτωση Βήμα προς Βήμα του uncensored.com LLM API
Η ενσωμάτωση ενός LLM χωρίς λογοκρισία στην εφαρμογή σας απαιτεί ακριβή διαμόρφωση της βάσης URL και των headers πιστοποίησης. Αυτός ο οδηγός σας καθοδηγεί στη ρύθμιση του uncensored.com API για δημιουργία κειμένου, streaming και χρήση εργαλείων χρησιμοποιώντας τυπικά SDK συμβατά με OpenAI.
Τελευταία ενημέρωση
Σύνοψη
- Η API χρησιμοποιεί τη βάση URL HTTPS://api.uncensoredaicom.com/v1 και το model ID "uncensored" για όλα τα αιτήματα.
- Η πιστοποίηση διαχειρίζεται μέσω ενός Bearer token στον header Authorization, που λαμβάνεται μετά την εγγραφή με Google ή email.
- Οι ροές απαντήσεων (streaming) ενεργοποιούνται ρυθμίζοντας stream=true, παραδίδοντας tokens μέσω Server-Sent Events.
- Η τιμολόγηση είναι διαφανής στα $0.15 ανά εκατομμύριο input tokens και $0.50 ανά εκατομμύριο output tokens, με προπληρωμένο υπόλοιπο κρυπτονομισμάτων που δεν λήγει ποτέ.
Προαπαιτούμενα: SDK και Ρύθμιση Περιβάλλοντος
Εγκαταστήστε το SDK της προτιμώμενης γλώσσας για επικοινωνία με το endpoint. Οι περισσότεροι προγραμματιστές χρησιμοποιούν το επίσημο SDK της OpenAI για Python, Node.js ή Go. Αυτό λειτουργεί επειδή το API ακολουθεί το τυπικό σχήμα chat completions της OpenAI.
Βεβαιωθείτε ότι το περιβάλλον σας διαθέτει Python 3.8+ ή Node.js 18+. Εγκαταστήστε το πακέτο μέσω pip ή npm. Θα χρειαστείτε ένα API key από το dashboard. Δεν απαιτείται αριθμός τηλεφώνου για την εγγραφή.
- Python:
pip install openai - Node.js:
npm install openai
Αποθηκεύστε το API key σας σε μια μεταβλητή περιβάλλοντος. Αυτό αποτρέπει την ακούσια έκθεση σε version control. Το key παρέχει πρόσβαση στο μοντέλο uncensored.
Ρύθμιση του Base URL
Κατευθύνετε τον πελάτη SDK στο σωστό βασικό URL. Αυτό είναι το πιο κρίσιμο βήμα για μια επιτυχημένη ολοκλήρωση. Το προεπιλεγμένο βασικό URL OpenAI δεν θα λειτουργήσει για αυτή την υπηρεσία.
Ορίστε το βασικό URL σε HTTPS://api.uncensoredaicom.com/v1. Αυτό κατευθύνει τα αιτήματα στην υποδομή LLM uncensored. Το ID μοντέλου που πρέπει να στείλετε είναι "uncensored". Είναι ένα μοντέλο ανοιχτού βάρους ρυθμισμένο για ελάχιστες απορρίψεις.
Επαληθεύστε τη σύνδεση καλώντας το endpoint των μοντέλων. Αυτό επιβεβαιώνει ότι τα διαπιστευτήριά σας και η βάση URL είναι σωστά. Μια επιτυχημένη απάντηση επιστρέφει το ID του μοντέλου και τον τύπο αντικειμένου.
Πιστοποίηση και Ρύθμιση Header
Περνάτε το API key σας στην κεφαλίδα Authorization. Χρησιμοποιήστε το σχήμα Bearer για όλες τις αιτήσεις. Αυτή η κεφαλίδα πιστοποιεί τον λογαριασμό προπληρωμένων κεφαλαίων σας.
Ορίστε την κεφαλίδα ως: Authorization: Bearer YOUR_API_KEY. Το SDK χειρίζεται αυτόματα αυτό αν περάσετε το κλειδί στον κατασκευαστή του client. Βεβαιωθείτε ότι δεν περιλαμβάνεται επιπλέον κενό. Τα άκυρα κλειδιά επιστρέφουν σφάλμα 401 Unauthorized.
Λαμβάνετε ένα ενεργό key ανά λογαριασμό. Η δημιουργία ενός νέου key ακυρώνει το προηγούμενο. Αυτό απλοποιεί την εναλλαγή και τη διαχείριση ασφαλείας των keys. Κρατήστε το key σας ασφαλές στο περιβάλλον deployment σας.
Αποστολή Τυπικού Αιτήματος Συνομιλίας
Κάντε μια POST αίτηση στο /v1/chat/completions. Στείλτε τα μηνύματά σας ως ένα array από αντικείμενα role και content. Το σύστημα υποστηρίζει τους ρόλους user, assistant και system.
Παράδειγμα δομής: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. Η API επιστρέφει συμπλήρωση κειμένου. Το παράθυρο συμφραζομένων είναι 100,000 tokens συνολικά. Μέγιστη έξοδος 16,000 tokens ανά αίτηση.
Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό. Αυτό προστατεύει το προπληρωμένο υπόλοιπό σας. Ορίστε τη θερμοκρασία και το top_p για έλεγχο. Οι προεπιλεγμένες τιμές λειτουργούν για τις περισσότερες περιπτώσεις χρήσης.
Ενεργοποίηση Streaming για Έξοδο σε Πραγματικό Χρόνο
Ορίστε stream: true στο σώμα του αιτήματός σας. Αυτό ενεργοποιεί τα Server-Sent Events (SSE). Τα tokens φτάνουν σταδιακά αντί να περιμένετε την πλήρη ολοκλήρωση.
Επεξεργαστείτε τη ροή SSE για να εμφανίσετε το κείμενο σε πραγματικό χρόνο. Το τελικό κομμάτι περιέχει στατιστικά χρήσης tokens. Αυτό επιτρέπει την ακριβή παρακολούθηση χρέωσης. Η ροή μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες.
Διαχειριστείτε διακοπές δικτύου με ευγένεια. Επανασυνδεθείτε αν η ροή διακοπεί. Το uncensored API υποστηρίζει σταθερό streaming. Παρακολουθήστε την κατάσταση σύνδεσης. Χρησιμοποιήστε το για διεπαφές συνομιλίας ή παραγωγή μακροχρόνιου κειμένου.
Χρησιμοποιώντας Tools και Function Calling
Ορίστε εργαλεία στο σώμα του αιτήματος. Δώστε μια λίστα σχημάτων συναρτήσεων. Το μοντέλο μπορεί να καλέσει αυτές τις συναρτήσεις βάσει της πρόθεσης του χρήστη. Αυτό επιτρέπει συμπεριφορά τύπου agent.
Προσδιορίστε tool_choice για τον έλεγχο της επιλογής συνάρτησης. Χρησιμοποιήστε auto για αυτόματη ανίχνευση. Το API υποστηρίζει τυπικούς ορισμούς εργαλείων. Επεξεργαστείτε τα ορίσματα της κλήσης συνάρτησης από την απόκριση.
Εφαρμόστε την εκτέλεση της συνάρτησης στον κώδικά σας. Στείλτε το αποτέλεσμα πίσω ως μήνυμα. Το μοντέλο συνεχίζει τη συνομιλία. Αυτό επιπλέκει πολύπλοκες ροές εργασίας. Ο έλεγχος διασφαλίζει ακριβή ανάλυση ορισμάτων.
Χειρισμός Αποκρίσεων Λειτουργίας JSON
Ορίστε response_format: {"type": "json_object"}. Αυτό αναγκάζει το μοντέλο να εξάγει έγκυρο JSON. Χρησιμοποιήστε το για εξαγωγή δομημένων δεδομένων. Αποτρέπει σφάλματα λανθασμένα διαμορφωμένων απαντήσεων.
Ανάλυση του συμβολοσειράς JSON στον κώδικά σας. Διαχειριστείτε πιθανά σφάλματα ανάλυσης. Η λειτουργία JSON βελτιώνει την αξιοπιστία για ενσωματώσεις API. Είναι ιδανική για ροές επεξεργασίας δεδομένων.
Συνδυάστε τη λειτουργία JSON με system prompts. Κατευθύνετε το μοντέλο να εξάγει συγκεκριμένα σχήματα. Αυτό διασφαλίζει συνεπή μορφοποίηση. Επαληθεύστε την έξοδο πριν τη χρησιμοποιήσετε. Αυτό μειώνει τα σφάλματα downstream.
Παρακολούθηση Ορίων και Σφαλμάτων
Σεβαστείτε τα όρια ρυθμού. Έχετε 300 αιτήματα ανά λεπτό ανά κλειδί. Μέγιστο 8 ταυτόχρονες συνδέσεις. Το μέγεθος του σώματος αιτήματος περιορίζεται στα 8 MB.
Παρακολουθήστε τους κωδικούς κατάστασης HTTP. Το 429 υποδεικνύει υπέρβαση ορίου ρυθμού. Το 400 υποδεικνύει κακή αίτηση. Το 500 υποδεικνύει σφάλμα διακομιστή. Εφαρμόστε εκθετική επαναπροσπάθεια για επαναλήψεις. Αυτό αποτρέπει την υπερφόρτωση του API.
Παρακολουθήστε τη χρήση tokens στο τελευταίο streaming chunk. Αυτό βοηθά στη διαχείριση του προκαταβλημένου πιστωτικού. Τα σφάλματα δεν καταναλώνουν tokens. Αυτό προστατεύει το υπόλοιπό σας. Η τακτική παρακολούθηση διασφαλίζει ομαλή λειτουργία.
Υπολογισμός Κόστους και Χρήσης Tokens
Η τιμολόγηση είναι διαφανής και prepaid. Τα input tokens κοστίζουν $0.15 ανά εκατομμύριο. Τα output tokens κοστίζουν $0.50 ανά εκατομμύριο. Το credit δεν λήγει ποτέ. Δεν ισχύουν μηνιαίες χρεώσεις.
Χρηματοδοτήστε μόνο με κρυπτονομίσματα. USDT (TRC20) ή USDC (Base). Τα ποσά κυμαίνονται από $20 έως $500. Το bonus credit εφαρμόζεται για μεγαλύτερα top-ups. +5% από $50, +10% από $100, +15% από $200.
Υπολογίστε τα κόστη πριν από τη βαριά χρήση. Εκτιμήστε τις μετρήσεις tokens για τα prompts σας. Αυτό βοηθά στον αποτελεσματικό προϋπολογισμό. Τα σφάλματα είναι δωρεάν. Δεν εκδίδονται επιστροφές χρημάτων, αλλά τα λάθη διορθώνονται. Χρησιμοποιήστε το dashboard για να παρακολουθήσετε τις δαπάνες.
Frequently asked questions
Είναι το uncensoredai.com συμβατό με το SDK της OpenAI;
Ναι, το API είναι πλήρως συμβατό με OpenAI. Μπορείτε να χρησιμοποιήσετε τα τυπικά OpenAI SDKs για Python, Node.js και άλλες γλώσσες. Αρκεί να αλλάξετε το base URL σε HTTPS://api.uncensoredaicom.com/v1 και να περάσετε το API key σας. Το model ID είναι "uncensored". Ακολουθεί την ίδια δομή αιτήματος και απόκρισης.
Ποιες πληρωμές crypto γίνονται αποδεκτές;
Δεχόμαστε USDT στο δίκτυο TRC20 και USDC στο δίκτυο Base. Μπορείτε να επαναφορτίσετε οποιοδήποτε ακέραιο ποσό μεταξύ $20 και $500. Το bonus πιστωτικό προστίθεται αυτόματα: +5% από $50, +10% από $100 και +15% από $200.
Το προκαταβλημένο credit λήγει;
Όχι, το προπληρωμένο υπόλοιπό σας δεν λήγει ποτέ. Δεν υπάρχουν μηνιαίες χρεώσεις συνδρομής ή προθεσμίες χρήσης. Πληρώνετε για αυτό που χρησιμοποιείτε και τα λάθη δεν καταναλώνουν υπόλοιπο. Αυτό το μοντέλο διασφαλίζει ότι πληρώνετε μόνο για την πραγματική αξία που λαμβάνετε.
Μπορώ να χρησιμοποιήσω αυτό το API για NSFW περιεχόμενο;
Ναι, το μοντέλο είναι uncensored και δεν απορρίπτει νόμιμο, ενηλίκων, φανταστικό ή αμφιλεγόμενο περιεχόμενο. Είναι σχεδιασμένο για μη περιορισμένη παραγωγή κειμένου. Το μόνο αυστηρό όριο αφορά το περιεχόμενο που εμπλέκει ανηλίκους, το οποίο απορρίπτεται πάντα. Είναι ιδανικό για NSFW chatbots και δημιουργική γραφή.
Δημιουργήστε το API key σας
Εγγραφείτε, ανακτήστε το κλειδί, ενημερώστε το base URL. Ελάχιστη διαμόρφωση απαιτείται.
