Προαπαιτούμενα: SDK και περιβάλλον
Ξεκινήστε εγκαθιστώντας το SDK συμβατό με το OpenAI που προτιμάτε. Χρειάζεστε μόνο ένα έγκυρο κλειδί API και το base URL για την υπηρεσία μας.
Εξάγετε το κλειδί στις μεταβλητές περιβάλλοντός σας ώστε τα σενάριά σας να μπορούν να το προσπελάσουν με ασφάλεια. Δημιουργήστε έναν νέο λογαριασμό μέσω Google ή email για να λάβετε το κλειδί σας άμεσα. Δεν απαιτείται επαλήθευση μέσω κινητού τηλεφώνου για αυτό το βήμα.
Βεβαιωθείτε ότι το περιβάλλον σας υποστηρίζει τυπικές βιβλιοθήκες HTTP. Το API αναμένει τυπικά payloads JSON για όλες τις αιτήσεις. Δεν χρειάζεται να εγκαταστήσετε drivers ειδικών κατασκευαστών.
Ρύθμιση της βασικής διεύθυνσης
Κατευθύνετε τον πελάτη SDK σας στο εξειδικευμένο endpoint μας για συμπερασμούς χωρίς λογοκρισία. Το βασικό URL αντικαθιστά το τυπικό endpoint OpenAI στις ρυθμίσεις σας.
Χρησιμοποιήστε το HTTPS://api.apikeymistral.com/v1 ως τη βάση URL. Αυτό διασφαλίζει ότι όλες οι αιτήσεις διακινούνται μέσω των εξυπηρετητών υψηλής χωρητικότητάς μας. Δεν χρειάζεται να αλλάξετε τη διαδρομή του endpoint αν το SDK σας ορίζει εξδιαλείψεως /chat/completions.
Διατηρήστε το API key σας στη μνήμη ή σε ένα ασφαλές vault. Το κλειδί πιστοποιεί κάθε αίτημα που στέλνετε σε αυτή τη διεύθυνση URL.
Κάντε την πρώτη POST αίτηση
Στείλτε ένα τυπικό αίτημα chat completion για να λάβετε κειμενική έξοδο. Χρησιμοποιήστε το model ID "uncensored" για να προσπελάσετε το ρυθμισμένο μοντέλο μας.
Προσδιορίστε τη θερμοκρασία και άλλες παραμέτρους για να ελέγξετε τη δημιουργικότητα. Το endpoint δέχεται τυπικά σώματα JSON με πίνακα μηνυμάτων.
Ακολουθεί μια βασική εντολή curl για τον έλεγχο σύνδεσης:
curl https://api.apikeymistral.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "return json object with keys name age"}]
}'Επαληθεύστε ότι η απόκριση περιέχει το generated text. Ελέγξτε ότι ο κωδικός κατάστασης είναι 200 για επιτυχία.
Ενσωμάτωση SDK Python
Ρυθμίστε τον πελάτη Python για να χρησιμοποιεί τη βάση URL μας. Αρχικοποιήστε τον πελάτη με το API key και το προσαρμοσμένο endpoint.
Καλέστε τη μέθοδο chat.completions.create με το prompt σας. Το αντικείμενο απόκρισης περιέχει το παραγόμενο κείμενο στο choices[0].message.content.
Διαχειριστείτε πιθανά σφάλματα όπως τα όρια ρυθμού ή τα άκυρα κλειδιά με επιτυχία. Καταγράψτε τη χρήση tokens αν χρειαστεί για την παρακολούθηση κόστους.
from openai import OpenAI
client = OpenAI(base_url="https://api.apikeymistral.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)Αυτή η προσέγγιση λειτουργεί με οποιαδήποτε OpenAI-compatible βιβλιοθήκη. Μπορείτε να επαναχρησιμοποιήσετε υπάρχοντα κώδικα με ελάχιστες αλλαγές.
Node SDK integration
Αρχικοποιήστε τον πελάτη Node.js με τη βάση URL. Περάστε το κλειδί API σας στο αντικείμενο διαμόρφωσης.
Καλέστε τη συνάρτηση chat.completions.create με τις επιθυμητές παραμέτρους σας. Η απόκριση ακολουθεί το τυπικό format OpenAI.
Επεξεργαστείτε τη ροή ή την τελική απάντηση όπως απαιτείται. Η διαχείριση σφαλμάτων πρέπει να πιάνει προβλήματα δικτύου ή αποτυχίες πιστοποίησης.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apikeymistral.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);Αυτή η ρύθμιση σας επιτρέπει να ενσωματώσετε συμπεράσματα χωρίς λογοκρισία στις εφαρμογές Node σας γρήγορα.
Διαχείριση streaming αποκρίσεων
Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας stream=true στην αίτησή σας. Η API επιστρέφει δεδομένα σε chunks καθώς παράγονται.
Επεξεργαστείτε κάθε τμήμα για να εμφανίσετε την έξοδο σε πραγματικό χρόνο στους χρήστες σας. Συσσωρεύστε το περιεχόμενο για να λάβετε την πλήρη απάντηση.
Παρακολουθήστε τη χρήση tokens στο τελευταίο chunk της ροής. Αυτό σας βοηθά να παρακολουθείτε τα κόστη με ακρίβεια.
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)Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροχρόνιες απαντήσεις. Είναι ιδανική για διεπαφές συνομιλίας και διαδραστικές εφαρμογές.
Όρια, σφάλματα και context window
Κατανοήστε τα τεχνικά όρια για να αποφύγετε διακοπές υπηρεσίας. Το παράθυρο συνάφειας υποστηρίζει 100,000 tokens για prompt και completion συνδυαστικά.
Η μέγιστη έξοδος είναι 16,000 tokens ανά αίτημα. Ορίστε το max_tokens ρητά για να αποφύγετε την προεπιλογή 2,048.
Οι περιορισμοί ρυθμού επιτρέπουν 300 αιτήματα ανά λεπτό ανά κλειδί. Μπορείτε να έχετε 8 ταυτόχρονα αιτήματα τη φορά.
Handle 401 errors ελέγχοντας την εγκυρότητα του key. 402 errors υποδηλώνουν ανεπαρκή πιστωτικό υπόλοιπο. 429 errors σημαίνουν ότι φτάσατε το όριο ρυθμού.
Οι αιτήσεις που ξεπερνούν το όριο μεγέθους σώματος 8 MB θα αποτύχουν. Σχεδιάστε το payload σας ανάλογα.
