Τεκμηρίωση API

Πιστοποίηση & Base URL

Ξεκινήστε κατευθύνοντας τον πελάτη σας στη σωστή βάση URL. Δεχόμαστε τυπικές κεφαλίδες OpenAI για συμβατότητα. Το API key σας τοποθετείται στην κεφαλίδα Authorization ως bearer token. Περάστε το απευθείας από τις μεταβλητές περιβάλλοντος για να αποφύγετε την σκληρή κωδικοποίηση μυστικών. Αυτή η ρύθμιση λειτουργεί με οποιαδήποτε βιβλιοθήκη υποστηρίζει το πρωτόκολλο OpenAI.

Πρώτη αίτηση

Στείλτε μια απλή ολοκλήρωση συνομιλίας για να επαληθεύσετε τη σύνδεση. Χρησιμοποιήστε το ID μοντέλου "uncensored" για παραγωγή κειμένου. Το endpoint επιστρέφει τυπικό JSON με επιλογές και μετρικές χρήσης. Αν λάβετε 401, ελέγξτε τη μορφή του κλειδιού σας. Το 402 υποδηλώνει ανεπαρκές προκαταβλημένο credit. Αυτή η γρήγορη δοκιμή επιβεβαιώνει ότι η ενσωμάτωσή σας είναι έτοιμη για παραγωγικό traffic.

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

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

Ρυθμίστε το πακέτο OpenAI Python για να χρησιμοποιεί τη βάση URL μας. Ορίστε το API key και το όνομα μοντέλου ρητά. Δώστε τα μηνύματά σας ως λίστα λεξικών με keys ρόλου και περιεχομένου. Το αντικείμενο απόκρισης περιέχει το παραγόμενο κείμενο στο choices[0].message.content. Χειριστείτε εξαιρέσεις με χάρη για να πιάσετε σφάλματα δικτύου ή ορίων ρυθμού κατά την εκτέλεση.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralbaseurl.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)

Ρύθμιση SDK Node.js

Εκκινήστε τον πελάτη OpenAI με τη βάση URL και το κλειδί σας. Ορίστε τον πίνακα μηνυμάτων με ρόλους χρήστη και βοηθού. Καλέστε το chat.completions.create με το μοντέλο uncensored. Η απόκριση παρέχει το παραγόμενο κείμενο στην πρώτη επιλογή. Χρησιμοποιήστε αυτό το μοτίβο τόσο για συγχρονισμένες όσο και για ασύγχρονες κλήσεις στις εφαρμογές Node σας.

Copyimport OpenAI from "openai";

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

Streaming Αποκρίσεις

Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας stream: true. Η API στέλνει chunks δεδομένων καθώς παράγονται. Κάθε chunk περιέχει κείμενο delta που μπορείτε να προσθέσετε σε ένα buffer. Αυτή η προσέγγιση μειώνει την αντιλαμβανόμενη καθυστέρηση για μεγάλα αποτελέσματα. Παρακολουθήστε τη χρήση tokens στο τελευταίο chunk για ακριβή παρακολούθηση της χρέωσης.

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)

Όρια & Παράθυρο Πλαισίου

Ο λογαριασμός σας υποστηρίζει παράθυρο πλαισίου 100,000 tokens. Μέγιστη έξοδος 16,000 tokens ανά αίτημα. Μπορείτε να στείλετε 300 αιτήματα ανά λεπτό. Μόνο 8 αιτήματα εκτελούνται ταυτόχρονα. Τα αιτήματα με μέγεθος σώματος πάνω από 8MB θα αποτύχουν. Χρησιμοποιήστε αυτά τα όρια για να σχεδιάσετε τη λογική επανάληψής σας. Σφάλματα όπως το 429 υποδεικνύουν χτύπημα ορίου ρυθμού. Οι απορρίψεις δεν καταναλώνουν πιστωτικές μονάδες.