API mistral ai: Οδηγός Γρήγορης Έναρξης

Βασικό URL και Αυθεντικοποίηση

Το πρώτο βήμα είναι η διαμόρφωση του client σας να δείχνει στην υποδομή μας. Αντικαταστήστε το τυπικό OpenAI base URL με HTTPS://api.apimistralai.com/v1 και εισάγετε το μοναδικό API key σας στην authorization header. Αυτή η απλή αλλαγή κατευθύνει όλες τις αιτήσεις στο uncensored model μας διατηρώντας την υπάρχουσα λογική ενσωμάτωσης αμετάβλητη.

• Base URL: HTTPS://api.apimistralai.com/v1
• Πιστοποίηση: Bearer token μέσω του Authorization header

Βεβαιωθείτε ότι το key σας είναι ενεργό στο dashboard του λογαριασμού σας πριν δοκιμάσετε τις συνδέσεις.

Πρώτη αίτηση

Στείλτε μια τυπική αίτηση ολοκλήρωσης συνομιλίας για να επαληθεύσετε τη σύνδεση και την απόκριση του μοντέλου. Τα παρακάτω curl command targets the uncensored το μοντέλο με ένα βασικό prompt.

Αυτό επιβεβαιώνει ότι το endpoint είναι προσβάσιμο και επιστρέφει κείμενο χωρίς τα τυπικά φίλτρα περιεχομένου.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Αν η απόκριση περιέχει κείμενο, η ενσωμάτωσή σας διαχειρίζεται επιτυχώς μέσω του στρώματος inference uncensored μας.

Ενσωμάτωση SDK Python

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για αλληλεπίδραση με το API μας χωρίς τροποποίηση της βασικής δομής αιτήματος. Αρχικοποιήστε τον πελάτη με τη νέα βάση URL και το API key σας, στη συνέχεια καλέστε chat.completions.create.

Αυτή η προσέγγιση σας επιτρέπει να διατηρήσετε όλη την υπάρχουσα Python λογική αποκτώντας ταυτόχρονα πρόσβαση στις δυνατότητες του μοντέλου uncensored.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.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, καθιστώντας τη μετοίκιση ομαλή για τους προγραμματιστές Python.

Node SDK Integration

Για περιβάλλοντα JavaScript ή TypeScript, αρχικοποιήστε το πακέτο OpenAI με τη custom base URL. Ορίστε το apiKey και baseURL properties πριν την κλήση chat.completions.create.

Αυτό εξασφαλίζει ότι οι εφαρμογές Node.js σας κατευθύνουν αιτήματα στο uncensored endpoint μας διατηρώντας τη συμβατότητα με τα τυπικά πρότυπα SDK.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.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);

Η δομή απάνσης παραμένει συνεπής με τα πρότυπα OpenAI, επιτρέποντας εύκολη ενσωμάτωση σε υπάρχοντα workflows Node.js.

Streaming Αποκρίσεις μέσω SSE

Ενεργοποιήστε την παραγωγή token σε πραγματικό χρόνο ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει μια ροή Server-Sent Events (SSE), επιτρέποντάς σας να επεξεργάζεστε token καθώς παράγονται.

Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες και παρέχει άμεση ανατροφοδότηση κατά τις μακρές ολοκληρώσεις.

Copystream = 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)

Ανάλυση της ροής δεδομένων SSE για εμφάνιση tokens_incrementally. Η τελευταία ενότητα περιέχει τη συνολική χρήση tokens για το αίτημα.

Όρια, Σφάλματα και Context

Παρακολουθήστε τη χρήση σας έναντι αυστηρών ορίων ρυθμού και διαχειριστείτε κοινά σφάλματα HTTP με χάρη. Επιτρέπονται 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί.

Ένα σφάλμα 401 υποδηλώνει μη έγκυρο ή λείπον κλειδί API, ενώ ένα σφάλμα 402 σημαίνει ότι το προκαταβλημένο υπόλοιπό σας εξαντλήθηκε. Η κατάσταση 429 σηματοδοτεί ότι έχετε ξεπεράσει το όριο των 300 αιτήσεων ανά λεπτό.

Το παράθυρο πλαισίου (context window) υποστηρίζει 100.000 tokens συνολικά, με μέγιστη έξοδο 16.000 tokens ανά αίτημα. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό υπόλοιπο, διασφαλίζοντας ότι πληρώνετε μόνο για το πραγματικό περιεχόμενο που δημιουργείται.