MiniMax api: Quickstart and SDK Guide

Autentificare și URL de bază

Folosește cheia API furnizată și indică clientului tău către URL-ul de bază dedicat. Endpoint-ul pentru generarea de răspunsuri este https://api.minimaxaiapi.com/v1/chat/completions. Transmiți cheia în Authorization header ca un token bearer. Acesta funcționează cu orice SDK standard OpenAI deoarece respectăm același protocol.

• Nume header: Authorization
• Valoare header: Bearer YOUR_API_KEY
• URL de bază: https://api.minimaxaiapi.com/v1

Nu este necesară o configurare complexă. Actualizați doar configurația din proiectul existent.

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"}]
  }'

Endpoint Completări Chat

Trimiteți o cerere POST către endpoint-ul de completări chat pentru a obține un răspuns text. Identificatorul modelului este uncensored. Trebuie să incluzi un array messages cu istoricul conversației tale. Sistemul procesează inputul și returnează textul generat bazat pe promptul tău.

Acest endpoint gestionează toate generările de text. Nu suportă embedding-uri, audio sau video. Puteți stream-ui răspunsurile sau puteți aștepta blocul complet. Modelul gestionează contextul până la un total de 100,000 de tokeni.

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)

Streaming și Utilizarea Tokenilor

Activați streaming-ul setând stream: true în cererea dumneavoastră. API-ul returnează Evenimente trimise de server (SSE) pentru fiecare token generat. Acest lucru permite afișarea în timp real a ieșirii. Statisticile de utilizare a tokenilor sunt incluse în fragmentul final al fluxului. Acest lucru vă ajută să urmăriți costurile cu precizie fără a analiza fiecare token individual.

Streaming-ul reduce latența percepută pentru răspunsurile lungi. Este ideal pentru interfețele de chat și generarea de conținut dinamic. Poți opri fluxul devreme dacă utilizatorul întrerupe generarea.

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);

Apelarea funcțiilor și modul JSON

Folosește tools parametru pentru a activa apelarea de funcții. Definește-ți funcțiile în corpul cererii și lasă modelul să aleagă pe care să o apeleze. API-ul tool_choice parametrul vă permite să forțați o funcție specifică sau să selectați automat. Pentru ieșiri JSON stricte, setați response_format pentru {"type": "json_object"}. Acest lucru asigură că răspunsul este JSON valid.

Apelarea de funcții este utilă pentru extragerea datelor structurate sau declanșarea de acțiuni. Modul JSON este perfect pentru integrările API care necesită formate predictibile. Combină ambele pentru o logică de aplicație robustă.

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)

Parametri Model și Constrângeri

Ajustați comportamentul de generare folosind parametri standard precum temperature, top_p, și stop. Fereastra maximă de context este de 100.000 de tokeni, inclusiv promptul și completarea. Output-ul maxim per solicitare este de 16.000 de tokeni. Dacă nu setezi max_tokens, limita implică 2.048 de tokeni.

Utilizare seed pentru rezultate reproducibile. Setarea presence_penalty și frequency_penalty pentru a controla repetiția. Acești parametri îți oferă un control fin al creativității și consistenței modelului. Testează întotdeauna cu cazul tău specific de utilizare pentru a găsi echilibrul potrivit.

Limite de rată și erori

API impune o limită de 300 de cereri pe minut și 8 cereri concurente per cheie. Dacă depășiți aceste limite, veți primi un cod de eroare 429. Un cod 401 indică o cheie API invalidă sau lipsă. Un cod 402 înseamnă că creditul preplătit este epuizat.

Erorile nu consumă creditul tău. Poți reîncerca cererile eșuate fără penalități. Dimensiunea corpului cererii este limitată la 8 MB. Gestionează-ți concurența cu grijă pentru a evita limitarea vitezei. Monitorizează-ți utilizarea prin intermediul ultimului fragment de răspunsuri în flux.