Γρήγορη Εκκίνηση API

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

Η API χρησιμοποιεί τυπική πιστοποίηση συμβατή με το OpenAI. Λαμβάνετε ένα API key αμέσως μετά την εγγραφή σας με Google ή email. Χρησιμοποιήστε αυτό το key στο Authorization header για όλες τις αιτήσεις. Η βασική διεύθυνση URL είναι σταθερή στο https://api.mistralabliterated.com/v1. Δεν απαιτείται επιπλέον διαμόρφωση για το μονοπάτι endpoint.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Το κλειδί σας ταυτοποιεί τον λογαριασμό σας και παρακολουθεί τη χρήση. Αν χάσετε το κλειδί σας, δημιουργήστε ένα νέο· το παλιό γίνεται άκυρο.

POST /v1/chat/completions

Στείλτε μηνύματα στο μοντέλο χρησιμοποιώντας την τυπική διεπαφή ολοκλήρωσης συνομιλίας. Το model ID είναι πάντα uncensored. Αυτό το endpoint διαχειρίζεται αλληλεπιδράσεις text-in, text-out χωρίς να απαιτεί πολύπλοκες δομές payload. Μπορείτε να στείλετε system, user, και assistant messages σε ένα single request.

Copyfrom openai import OpenAI

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

Η αίτηση επιστρέφει μια δομημένη απάντηση JSON που περιέχει την έξοδο του μοντέλου. Μπορείτε να ρυθμίσετε παραμέτρους όπως temperature και top_p για να ελέγξετε τη δημιουργικότητα. Το μοντέλο δεν απορρίπτει νόμιμα ενήλικα ή αμφιλεγόμενα θέματα, παρένοντας ένα raw response style. Τα σφάλματα επιστρέφουν τυπικούς κωδικούς κατάστασης HTTP για εύκολη αποσφαλμάτωση στο codebase σας.

GET /v1/models

Κάντε ερώτημα στα διαθέσιμα μοντέλα για να επαληθεύσετε τη συνδεσιμότητα και τη διαμόρφωση. Αυτό το endpoint επιστρέφει μια λίστα διαθέσιμων μοντέλων, επιβεβαιώνοντας ότι η ταυτοποίηση και η base URL είναι σωστές. Είναι χρήσιμο για τη δοκιμή της ενσωμάτωσής σας πριν στείλετε μεγάλα payloads.

Copyimport OpenAI from "openai";

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

Η απάντηση περιλαμβάνει το ID του μοντέλου και τον τύπο αντικειμένου. Μπορείτε να χρησιμοποιήσετε αυτή την ενότητα στη διαδικασία εκκίνησης της εφαρμογής σας για να διασφαλίσετε ότι το API είναι προσβάσιμο. Επιστρέφει άμεσα με χαμηλή καθυστέρηση, καθιστώντας την ιδανική για έλεγχο υγείας. Δεν καταναλώνεται πιστωτική μονάδα από αυτή την αίτηση.

Ροή & Εργαλεία

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

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)

Τα στατιστικά χρήσης tokens περιλαμβάνονται στο τελικό chunk του stream. Αυτό σας επιτρέπει να παρακολουθείτε το κόστος σε πραγματικό χρόνο. Το μοντέλο υποστηρίζει JSON mode για δομημένες εξόδους όταν ορίσετε response_format για {"type": "json_object"}. Οι επιλογές εργαλείων είναι ευέλικτες, επιτρέποντας συγκεκριμένη ή αυτόματη επιλογή.

Parameters & Limits

Το παράθυρο πλαισίου υποστηρίζει 100,000 tokens για συνδυασμένη εισαγωγή και παραγωγή. Η μέγιστη έξοδος ανά αίτημα είναι 16,000 tokens, ή 2,048 αν δεν καθορίσετε max_tokens. Μπορείτε να ελέγξετε την παραγωγή με temperature, top_p, stop, και seed parameters. Διατίθενται επίσης οι συχνότητες και οι ποινές παρουσίας για λεπτομερή ρύθμιση.

Οι περιορισμοί ρυθμού επιτρέπουν 300 αιτήματα ανά λεπτό ανά κλειδί και 8 ταυτόχρονα αιτήματα. Το μέγιστο μέγεθος σώματος αιτήματος είναι 8 MB. Αυτά τα όρια διασφαλίζουν σταθερή απόδοση για εφαρμογές υψηλής απόδοσης. Προσαρμόστε τη στρατηγική ομαδοποίησης (batching) για να μείνετε εντός αυτών των ορίων.

Σφάλματα & Τιμολόγηση

HTTP 401 υποδηλώνει μη έγκυρο ή λανθασμένο API key. HTTP 402 σημαίνει ότι εξαντλήθηκαν τα προπληρωμένα χρήματά σας· συμπληρώστε με κρυπτονομίσματα για να συνεχίσετε. HTTP 429 σηματοδοτεί εξάντληση του ορίου ρυθμού· περιμένετε ή μειώστε τη ταυτόχρονη χρήση. Τα σφάλματα δεν καταναλώνουν πιστωτικό υπόλοιπο, οπότε δεν χρεώνεστε για αποτυχημένες αιτήσεις.

Η τιμολόγηση είναι $0.15 ανά εκατομμύριο input tokens και $0.50 ανά εκατομμύριο output tokens. Το credit δεν λήγει ποτέ, και δεν υπάρχουν μηνιαίες χρεώσεις. Οι αναπληρώσεις ξεκινούν από $20 με μπόνους για μεγαλύτερα ποσά. Οι επιστροφές δεν είναι διαθέσιμες, αλλά η υποστήριξη μπορεί να διορθώσει διπλές χρεώσεις.