Βασικό URL και Αυθεντικοποίηση
Συνδεθείτε άμεσα κατευθύνοντας τον πελάτη σας στη βάση URL μας και περνώντας το κλειδί σας στην κεφαλίδα. Η πιστοποίηση είναι απλή: περιλαμβάνετε Authorization: Bearer YOUR_API_KEY με κάθε request. Λαμβάνετε το key σας άμεσα μετά την εγγραφή με Google ή email. Δεν απαιτείται αριθμός τηλεφώνου, και το key εμφανίζεται οθόνη αμέσως. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε τυπικό OpenAI-compatible SDK επειδή ακολουθούμε την ίδια δομή διεπαφής. Δεν χρειάζεται να διαχειρίζεστε σύνθετα sessions σύνδεσης ή να αντιμετωπίζετε λήψεις session που ταλαιπωρούν άλλες πλατφόρμες. Το key σας είναι το μόνο διαπιστευτήριο που χρειάζεστε για όλα τα endpoints. Αυτή η απλότητα σημαίνει ότι μπορείτε να ενσωματώσετε το API στα scripts ή τις εφαρμογές σας χωρίς ανησυχία για κύκλους ανανέωσης token ή ροές OAuth. Η υπηρεσία είναι σχεδιασμένη για developers που θέλουν άμεση πρόσβαση χωρίς бюрокρατικά εμπόδια. Παρέχουμε μια καθαρή, προβλέψιμη διεπαφή που συμπεριφέρεται ακριβώς όπως το βιομηχανικό πρότυπο. Αυτό μειώνει σημαντικά τον χρόνο ενσωμάτωσης σε σύγκριση με την πάλη με ιδιόκτητα συστήματα σύνδεσης.
Τερματικό Συμπληρώματος Συζήτησης
Στείλτε μηνύματα στο μοντέλο χωρίς λογοκρισία χρησιμοποιώντας την τυπική διεπαφή ολοκλήρωσης συνομιλίας. Η διεπαφή δέχεται αιτήματα POST στο /v1/chat/completions με ένα JSON body που περιέχει τα messages σας. Πρέπει να ορίσετε το model id ως uncensored για να χρησιμοποιήσετε το συγκεκριμένο μεγάλο μοντέλο γλώσσας μας. Το σύστημα επιστρέφει απαντήσεις κειμένου που μπορείτε να επεξεργαστείτε ή να εμφανίσετε. Αυτή είναι μια API εισόδου κειμένου, εξόδου κειμένου χωρίς δυνατότητες παραγωγής εικόνας ή ήχου. Ελέγχετε τον τόνο και το στυλ προσαρμόζοντας παραμέτρους όπως η θερμοκρασία ή το top_p. Η μορφή απόκρισης είναι συνεπής και προβλέψιμη, διευκολύνοντας την ανάλυση σε οποιαδήποτε γλώσσα. Μπορείτε να στείλετε πολλαπλές στροφές σε μια αίτηση για να διατηρήσετε την ιστορία συνομιλίας. Αυτή η προσέγγιση μιμείται τη συμπεριφορά των μεγάλων παρόχων προσφέροντας παράλληλα το συγκεκριμένο μοντέλο uncensored μας. Είναι η βασική λειτουργία για την κατασκευή chatbots, βοηθών ή παραγωγών περιεχομένου. Η διαδρομή είναι βελτιστοποιημένη για ταχύτητα και αξιοπιστία.
Ενσωμάτωση SDK Python
Ενσωματώστε γρήγορα χρησιμοποιώντας το επίσημο Python SDK με ελάχιστη διαμόρφωση. Απλά χρειάζεται να ορίσετε το base URL και το API key στην αρχικοποίηση του πελάτη σας. Το απόσπασμα κώδικα παρακάτω δείχνει πώς να δημιουργήσετε μια απλή αίτηση ολοκλήρωσης συνομιλίας. Αυτή η μέθοδος λειτουργεί άψογα με υπάρχοντα codebases OpenAI επειδή η διεπαφή είναι ταυτόσημη. Μπορείτε να περάσετε μια λίστα μηνυμάτων με ρόλους όπως system, user, ή assistant. Το αντικείμενο απάντησης σας δίνει πρόσβαση στο παραγόμενο κείμενο και στη χρήση tokens. Αυτό καθιστά τον εντοπισμό σφαλμάτων και την παρακολούθηση της εφαρμογής σας απλούς. Δεν χρειάζεται να γράψετε προσαρμοσμένους πελάτες HTTP ή να χειριστείτε χειροκίνητα τη σειριοποίηση JSON. Το SDK αναλαμβάνει όλη τη βαριά δουλειά για εσάς. Αυτό μειώνει τον κώδικα boilerplate και επιταχύνει σημαντικά τους κύκλους ανάπτυξης. Μπορείτε να ξεκινήσετε την πρωτότυπη ανάπτυξη σε λίγα λεπτά και να κλιμακώσετε αργότερα όταν χρειαστεί. Η βιβλιοθήκη είναι καλά τεκμηριωμένη και ενεργά συντηρούμενη.
Node SDK Integration
Χρησιμοποιήστε το Node.js SDK για να ενσωματώσετε το API σε έργα JavaScript ή TypeScript. Η ρύθμιση είναι παρόμοια με την Python: ρυθμίστε το base URL και το key μία φορά. Το παράδειγμα κώδικα δείχνει μια απλή αίτηση στο endpoint chat. Μπορείτε να χρησιμοποιήστε την ίδια δομή μηνυμάτων όπως στην Python, διασφαλίζοντας συνέπεια σε όλο το stack σας. Το αντικείμενο απάνσης παρέχει το κείμενο completion και στατιστικά χρήσης. Αυτό είναι χρήσιμο για την παρακολούθηση κατανάλωσης tokens στις εφαρμογές Node σας. Το SDK διαχειρίζεται streaming και διαχείριση σφαλμάτων εσωτερικά, απλοποιώντας τον κώδικά σας. Μπορείτε να το ενσωματώσετε σε Express routes, serverless συναρτήσεις ή background jobs. Η διεπαφή είναι οικεία σε όποιον έχει χρησιμοποιήσει την OpenAI Node βιβλιοθήκη. Αυτό σημαίνει ότι μπορείτε να επαναχρησιμοποιήσετε υπάρχουσα λογική και μοτίβα χωρίς να μάθετε μια νέα δομή API. Ταιριάζει φυσικά σε μοντέρνα JavaScript ecosystems. Αποκτάτε τα οφέλη μιας τυποποιημένης διεπαφής με τις συγκεκριμένες δυνατότητες μοντέλου μας. Αυτό μειώνει το γνωστικό φορτίο όταν εναλλάσσετε μεταξύ διαφορετικών τμημάτων της εφαρμογής σας.
Streaming Αποκρίσεις
Ενεργοποίηση εξόδου σε πραγματικό χρόνο ορίζοντας την παράμετρο stream σε true στην αίτησή σας. Το API επιστρέφει μια ροή chunks αντί για μια μοναδική πλήρη απάντηση. Αυτό είναι ιδανικό για διεπαφές chat όπου θέλετε να δείξετε κείμενο καθώς παράγεται. Κάθε chunk περιέχει μια μερική απάντηση, επιτρέποντάς σας να ενημερώνετε το interface χρήστη σταδιακά. Το τελευταίο chunk περιλαμβάνει τη συνολική χρήση token για την αίτηση. Αυτή η λειτουργία λειτουργεί τόσο με SDK Python όσο και Node με ελάχιστες αλλαγές κώδικα. Χειρίζεστε τη ροή επαναλαμβάνοντας τα chunks και προσαρτώντας το κείμενο. Αυτό δημιουργεί μια πιο ομαλή εμπειρία χρήστη σε σύγκριση με την αναμονή για την πλήρη απάντηση. Είναι ιδιαίτερα χρήσιμο για παραγωγή περιεχομένου μακρού μήκους ή πολύπλοκες εργασίες σκέψης. Η δυνατότητα streaming είναι τυπική στις σύγχρονες APIs LLM και υποστηρίζεται πλήρως εδώ. Μπορείτε να ελέγξετε τη ροή διαχειρίζοντας τον ρυθμό κατανάλωσης της ροής. Αυτό σας δίνει λεπτομερή έλεγχο του πώς εμφανίζεται η έξδοση στον χρήστη.
Όρια, Σφάλματα και Context
Το παράθυρο πλαισίου (context window) υποστηρίζει έως 100.000 tokens για την εισερχόμενη και την εξερχόμενη απάντηση συνολικά. Μπορείτε να στείλετε έως 8 ταυτόχρονες αιτήσεις ανά κλειδί και 300 αιτήσεις ανά λεπτό. Αν υπερβείτε αυτά τα όρια, θα λάβετε σφάλμα ορίου ρυθμού 429. Τα σφάλματα ελέγχου ταυτότητας επιστρέφουν κατάσταση 401 αν το κλειδί σας είναι άκυρο. Η κατάσταση 402 υποδεικνύει ότι το προκαταβληθέν υπόλοιπό σας εξαντλήθηκε. Μπορείτε να το пополните με κρυπτονομίσματα οποιαδήποτε στιγμή για να συνεχίσετε την υπηρεσία. Τα σφάλματα δεν καταναλώνουν το υπόλοιπό σας, οπότε οι αποτυχημένες αιτήσεις είναι δωρεάν. Η μέγιστη έξοδος ανά αίτημα είναι 16.000 tokens, ή 2.048 αν δεν ορίσετε όριο. Τα σώματα αιτήματος περιορίζονται στα 8 MB. Αυτά τα όρια σχεδιάστηκαν για διασφάλιση δίκαιης χρήσης και σταθερότητας συστήματος. Μπορείτε να παρακολουθείτε τη χρήση σας μέσω των headers της απόκρισης ή των αντικειμένων SDK. Αυτή η διαφάνεια σας βοηθά να διαχειριστείτε τον προϋπολογισμό σας και να σχεδιάσετε αποτελεσματικά την αρχιτεκτονική της εφαρμογής σας. Το μοντέλο προκαταβολής σημαίνει ότι πληρώνετε μόνο για ό,τι χρησιμοποιείτε, χωρίς κρυφές χρεώσεις.
cURL
curl https://api.mistralapilogin.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix my token expiry error"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapilogin.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapilogin.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);Ροή
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)