MiniMax api: Quickstart and SDK Guide

Authentication and Base URL

Χρησιμοποιήστε το παρεχόμενο API key και κατευθύνετε τον πελάτη σας στη αφιερωμένη βάση URL. Το endpoint για τη δημιουργία απαντήσεων είναι https://api.minimaxaiapi.com/v1/chat/completions.Περάστε το key στο Authorization header ως bearer token. Λειτουργεί με οποιοδήποτε τυπικό SDK OpenAI επειδή ακολουθούμε το ίδιο πρωτόκολλο.

• Όνομα Header: Authorization
• Αξία Header: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Δεν απαιτείται σύνθετο setup. Αρκεί να ενημερώσετε τη διαμόρφωση στο υπάρχον έργο σας.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Τερματικό Συμπληρώματος Συζήτησης

Στείλτε μια αίτηση POST στο endpoint chat completions για να λάβετε απάντηση κειμένου. Το αναγνωριστικό μοντέλου είναι uncensored.Πρέπει να συμπεριλάβετε μια messages array με την ιστορία συνομιλίας σας. Το σύστημα επεξεργάζεται την είσοδο και επιστρέφει παραγόμενο κείμενο βάσει του prompt σας.

Αυτό το endpoint διαχειρίζεται όλη την παραγωγή κειμένου. Δεν υποστηρίζει embeddings, ήχο ή βίντεο. Μπορείτε να κάνετε streaming στις απαντήσεις ή να περιμένετε το πλήρες μπλοκ. Το μοντέλο διαχειρίζεται πλαίσιο (context) έως 100,000 tokens συνολικά.

Copyfrom openai import OpenAI

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

Ροή και Χρήση Tokens

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

Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροχρόνιες απαντήσεις. Είναι ιδανική για διεπαφές συνομιλίας και δυναμική δημιουργία περιεχομένου. Μπορείτε να διακόψετε τη ροή νωρίς αν ο χρήστης διακόψει τη δημιουργία.

Copyimport OpenAI from "openai";

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

Function Calling και JSON Mode

Χρησιμοποιήστε το tools παράμετρος για τη δυνατότητα κλήσης συναρτήσεων. Ορίστε τις συναρτήσεις σας στο σώμα του αιτήματος και αφήστε το μοντέλο να επιλέξει ποια να καλέσει. Το tool_choice η παράμετρος σας επιτρέπει να αναγκάσετε μια συγκεκριμένη συνάρτηση ή αυτο-επιλογή. Για αυστηρή έξοδο JSON, ορίστε response_format για {"type": "json_object"}. Αυτό εξασφαλίζει ότι η απόκριση είναι έγκυρο JSON.

Η κλήση συναρτήσεων είναι χρήσιμη για την εξαγωγή δομημένων δεδομένων ή την ενεργοποίηση ενεργειών. Η λειτουργία JSON είναι ιδανική για ενσωματώσεις API που απαιτούν προβλέψιμες μορφές. Συνδυάστε και τα δύο για ισχυρή λογική εφαρμογής.

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)

Παράμετροι Μοντέλου και Περιορισμοί

Προσαρμόστε τη συμπεριφορά παραγωγής χρησιμοποιώντας τυπικές παραμέτρους όπως temperature, top_p, και stop. Το μέγιστο παράθυρο συνάφειας είναι 100,000 tokens συμπεριλαμβανομένου του prompt και της συμπλήρωσης. Η μέγιστη έξοδος ανά αίτημα είναι 16,000 tokens. Αν δεν ορίσετε max_tokens, το όριο προεπιλογής είναι 2.048 tokens.

Χρήση seed για αναπαραγώγιμα αποτελέσματα. Ορίστε presence_penalty και frequency_penalty για τον έλεγχο επανάληψης. Αυτές οι παράμετροι σας δίνουν λεπτομερή έλεγχο της δημιουργικότητας και της συνέπειας του μοντέλου. Δοκιμάστε πάντα με την συγκεκριμένη περίπτωσή σας για να βρείτε την σωστή ισορροπία.

Όρια Ρυθμού και Σφάλματα

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

Τα σφάλματα δεν καταναλώνουν το πιστωτικό σας υπόλοιπο. Μπορείτε να επαναλάβετε τις αποτυχημένες αιτήσεις χωρίς ποινή. Το μέγεθος του σώματος της αίτησης περιορίζεται στα 8 MB. Διαχειριστείτε προσεκτικά τη ταυτόχρονη χρήση για να αποφύγετε τον περιορισμό ρυθμού. Παρακολουθήστε τη χρήση σας μέσω του τελευταίου κομματιού των streaming απαντήσεων.