Ενσωματώστε το API σε Λεπτά
Προσθέστε το uncensored API μας στον υπάρχοντα codebase σας και παρακάμψτε τις απορρίψεις περιεχομένου ακαριαία. Αυτό το quickstart σας καθοδηγεί στη ρύθμιση της βάσης URL, την αποστολή του πρώτου αιτήματος και την επεξεργασία streaming responses με μηδενική τριβή.
Εγκατάσταση & Ρύθμιση Βάσης URL
Ρυθμίστε τον πελάτη σας να κατευθύνει στο endpoint μας συμβατό με OpenAI αμέσως.
Η API μας βρίσκεται στο https://api.codedeepseek.cc/v1.Χρειάζεται μόνο να αλλάξετε το base_url και παρέχετε το API key σας. Αυτή η ρύθμιση λειτουργεί με τα επίσημα SDK για Python και Node.js, διασφαλίζοντας ότι ο υπάρχων κώδικάς σας παραμένει αμετάβλητος. Δεν απαιτείται σύνθετη διαμόρφωση δρομολόγησης ή proxy.
Εγγραφείτε μέσω Google ή email για να λάβετε το κλειδί σας άμεσα. Δεν απαιτείται αριθμός τηλεφώνου και το κλειδί εμφανίζεται στην οθόνη αμέσως. Αυτή η απλότητα σας επιτρέπει να εστιάσετε στην ενσωμάτωση αντί σε διοικητικές διαδικασίες.
Πιστοποίηση
Συμπεριλάβετε το κλειδί σας στο Authorization header για κάθε αίτηση. Η μορφή του header είναι τυπική: Authorization: Bearer YOUR_API_KEY. Δεν χρησιμοποιούμε παραμέτρους ερώτησης για έλεγχο ταυτότητας, κρατώντας τις διευθύνσεις URL καθαρές και ασφαλείς.
Ένα ενεργό κλειδί ανά λογαριασμό διασφαλίζει απλή παρακολούθηση χρήσης. Εάν χρειαστείτε ένα νέο κλειδί, η δημιουργία ενός νέου αντικαθιστά αμέσως το παλιό. Αυτή η λειτουργία είναι χρήσιμη για την περιστροφή διαπιστευτηρίων σε περιβάλλοντα παραγωγής χωρίς διακοπή λειτουργίας.
Αποστολή της πρώτης σας αίτησης
Κάντε ένα τυπικό chat.completions call για παραγωγή κειμένου από το uncensored model.
Χρησιμοποιήστε το Model ID uncensored για όλες τις αιτήσεις. Αυτό το open-weight μοντέλο τρέχει στους servers μας και δεν απορρίπτει νόμιμα ενήλικα, φανταστικά ή αμφιλεγόμενα θέματα. Έχει σχεδιαστεί για developers που θέλουν unrestricted output για προγραμματισμό και δημιουργικές εργασίες.
Το παρακάτω παράδειγμα δείχνει μια βασική αίτηση χρησιμοποιώντας cURL. Αντικαταστήστε YOUR_API_KEY με το πραγματικό σας key.
curl https://api.codedeepseek.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix the null pointer in the java service class"}]
}'Βεβαιωθείτε ότι το request body περιλαμβάνει ένα messages array με τουλάχιστον ένα μήνυμα χρήστη. Το API αναμένει είσοδο κειμένου και επιστρέφει έξοδο κειμένου. Αυτή η απλότητα επιτρέπει γρήγορο πρωτοτυποποίηση χωρίς να ανησυχείτε για πολύπλοκες δομές payload.
Μπορείτε να δοκιμάσετε το endpoint απευθείας στο terminal ή το script σας. Αυτό το άμεσο feedback loop σας βοηθά να επαληθεύσετε τη σύνδεση πριν την ενσωμάτωση σε μεγαλύτερες εφαρμογές.
Streaming Αποκρίσεις με SSE
Ενεργοποιήστε την παραγωγή token σε πραγματικό χρόνο ρυθμίζοντας stream: true στο αίτημά σας.
Server-Sent Events (SSE) παραδίδουν tokens καθώς παράγονται, μειώνοντας την αντιλαμβανόμενη καθυστέρηση για μεγάλες εξόδους. Το τελευταίο κομμάτι στο ρεύμα περιέχει τη συνολική χρήση tokens για την αίτηση. Αυτή η λειτουργία είναι απαραίτητη για διεπαφές chat όπου οι χρήστες περιμένουν άμεσες απαντήσεις.
from openai import OpenAI
client = OpenAI(base_url="https://api.codedeepseek.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)Διαχειριστείτε τη ροή επαναλαμβάνοντας τα αντικείμενα απόκρισης. Κάθε αντικείμενο αντιπροσωπεύει ένα μεμονωμένο token ή διαφορά. Μπορείτε να συνδέσετε αυτές τις διαφορές για να χτίσετε το πλήρες κείμενο απόκρισης. Αυτή η προσέγγιση διατηρεί την εφαρμογή σας ανταποκρινόμενη ακόμη και υπό έντονο φορτίο.
Η ροή δεδομένων (streaming) υποστηρίζεται για όλες τις απαντήσεις μοντέλων. Χρησιμοποιήστε την για να ενισχύσετε την εμπειρία χρήστη σε βοηθά κώδικα ή εργαλεία παραγωγής περιεχομένου. Το μοντέλο uncensored διαχειρίζεται μακριά πλαίσια αποδοτικά, εξασφαλίζοντας ομαλή ροή δεδομένων ακόμη και για εκτεταμένες εξόδους.
Συνάρτηση Calling & Εργαλεία
Ενσωματώστε εξωτερικά εργαλεία ορίζοντας συναρτήσεις στο payload του αιτήματός σας.
Η API υποστηρίζει τυπικό function calling στυλ OpenAI. Ορίστε τα tools σας στο tools parameter και αφήστε το μοντέλο να αποφασίσει πότε να τα καλέσει. Αυτή η δυνατότητα επιπλέκει σύνθετα workflows όπως εκτέλεση κώδικα ή ανάκτηση δεδομένων.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.codedeepseek.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);Προσδιορίστε το όνομα και την περιγραφή της συνάρτησης καθαρά. Το μοντέλο θα επιστρέψει ένα αντικείμενο κλήσης συνάρτησης αν καθορίσει ότι το εργαλείο είναι απαραίτητο. Στη συνέχεια εκτελείτε τη συνάρτηση και τροφοδοτείτε το αποτέλεσμα πίσω στη συζήτηση.
Αυτή η λειτουργία είναι ιδιαίτερα χρήσιμη για agents κώδικα που χρειάζεται να εκτελέσουν αποσπάσματα κώδικα ή να ανακτήσουν τεκμηρίωση. Το uncensored μοντέλο κατανοεί καλά το πλαίσιο, μειώνοντας τα ψευδώς θετικά στην επιλογή εργαλείων.
Βεβαιωθείτε ότι οι ορισμοί εργαλείων σας ταιριάζουν με το αναμενόμενο schema εισόδου. Οι ασυμφωνίες μπορεί να οδηγήσουν σε σφάλματα ή απροσδόκητη συμπεριφορά. Δοκιμάστε την ενσωμάτωσή σας με εργαλεία σχολαστικά πριν την ανάπτυξη στην παραγωγή.
Λειτουργία JSON για Δομημένη Έξοδο
Εξαναγκάστε το μοντέλο να επιστρέψει έγκυρο JSON ρυθμίζοντας response_format για {"type": "json_object"}.
Αυτή η λειτουργία είναι ιδανική για εφαρμογές που απαιτούν δομημένα δεδομένα, όπως αρχεία διαμόρφωσης ή απαντήσεις API. Το μοντέλο θα προσπαθήσει να συμμορφωθεί με τη σύνταξη JSON, μειώνοντας την ανάγκη για μετα-επεξεργασία.
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)Χρησιμοποιήστε JSON mode σε συνδυασμό με streaming για πραγματικής χρονικής υστέρησης παράδοση δομημένων δεδομένων. Αυτός ο συνδυασμός είναι ισχυρός για τη δημιουργία δυναμικών web εφαρμογών που καταναλώνουν δεδομένα API.
Ενώ η λειτουργία JSON βελτιώνει τη δομή, ενδέχεται σπάνια να παράγει μη έγκυρο JSON αν το prompt είναι ασαφές. Πάντα να επαληθεύετε την έξοδο στον κώδικα της εφαρμογής σας. Αυτό το επιπλέον βήμα διασφαλίζει την αξιοπιστία σε περιβάλλοντα παραγωγής.
Το μοντέλο χωρίς λογοκρισία διαχειρίζεται αποτελεσματικά πολύπλοκες δομές JSON. Χρησιμοποιήστε το για τη δημιουργία αποσπασμάτων κώδικα, αντικειμένων διαμόρφωσης ή μετασχηματισμών δεδομένων.
Παράμετροι: Θερμοκρασία, Top-P, και Seed
Ελέγξτε την τυχαιότητα και την αναπαραγωγιμότητα των εξόδων σας χρησιμοποιώντας τυπικές παραμέτρους.
Ορίστε temperature μεταξύ 0 και 2 για ποικίλη δημιουργικότητα. Χαμηλότερες τιμές παράγουν πιο ντετερμινιστικά αποτελέσματα, ενώ υψηλότερες τιμές αυξάνουν την τυχαιότητα. Χρησιμοποιήστε top_p για δειγματοληψία πυρήνα, η οποία περιορίζει τη μάζα πιθανότητας των εξεταζόμενων tokens.
"Το seed parameter επιτλεί αναπαραγώγιμες εξόδους. Ορίστε μια συγκεκριμένη τιμή seed για να λάβετε την ίδια απάντηση σε πολλαπλές κλήσεις. Αυτό είναι χρήσιμο για debugging και testing.
Συνδυάστε αυτές τις παραμέτρους για να βελτιστοποιήσετε τη συμπεριφορά του μοντέλου για την συγκεκριμένη περίπτωσή σας. Για παράδειγμα, χρησιμοποιήστε χαμηλή θερμοκρασία και σταθερό seed για παραγωγή κώδικα όπου η συνέπεια είναι κρίσιμη.
Πειραματιστείτε με διαφορετικές ρυθμίσεις για να βρείτε την βέλτιστη ισορροπία για την εφαρμογή σας. Το API υποστηρίζει όλες τις τυπικές παραμέτρους OpenAI, διασφαλίζοντας συμβατότητα με υπάρχοντα εργαλεία.
Frequently asked questions
Ποιο είναι το όριο πλαισίου συμφραζομένων για το μοντέλο χωρίς φιλτράρισμα;
Το παράθυρο συμφραζομένων είναι 100.000 tokens, καλύπτοντας την εντολή και την απάντηση. Αυτό επιτρέπει εκτεταμένες συνομιλίες και μεγάλα αρχεία κώδικα. Μέγιστη έξοδος ανά αίτηση 16.000 tokens, ή 2.048 αν δεν οριστεί max_tokens.
Πώς διαχειρίζομαι σφάλματα όπως όρια συχνότητας ή ανεπαρκές υπόλοιπο;
Ένα σφάλμα 401 υποδηλώνει μη έγκυρο κλειδί API. Ένα σφάλμα 402 σημαίνει ότι έχετε ανεπαρκές προκαταβλημένο υπόλοιπο. Ένα σφάλμα 429 σημαίνει ότι έχετε φτάσει στο όριο ταχύτητας 300 αιτήσεων ανά λεπτό. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν υπόλοιπο.
Αυτό το API είναι συμβατό με υπάρχοντα SDKs OpenAI;
Ναι, είναι ένα API συμβατό με OpenAI. Μπορείτε να χρησιμοποιήσετε τα επίσημα SDKs Python και Node.js απλώς αλλάζοντας τη βάση URL και το API key. Αυτό διασφαλίζει ότι ο υπάρχων κώδικάς σας λειτουργεί με ελάχιστες αλλαγές.
Ξεκινήστε με δωρεάν πιστωτικά ορια
Εισάγετε email και κωδικό, εμφανίζεται κλειδί άμεσα.