MiniMax api: Przewodnik szybkiego startu i SDK

Uwierzytelnianie i URL bazowy

Użyj dostarczonego klucza API i wskaż swojego klienta na dedykowany adres URL bazowy. Punkt końcowy do generowania odpowiedzi to https://api.minimaxaiapi.com/v1/chat/completions. Przekazujesz klucz w Authorization nagłówek jako token Bearer. Działa z dowolnym standardowym SDK OpenAI, ponieważ stosujemy ten sam protokół.

• Nazwa nagłówka: Authorization
• Wartość nagłówka: Bearer YOUR_API_KEY
• URL bazowy: https://api.minimaxaiapi.com/v1

Nie jest wymagana skomplikowana konfiguracja. Wystarczy zaktualizować konfigurację w istniejącym projekcie.

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

Punkt końcowy Uzupełnień Czat

Wyślij żądanie POST do endpointu chat completions, aby uzyskać odpowiedź tekstową. Identyfikator modelu to uncensored. Musisz dołączyć tablicę messages z historią rozmowy. System przetwarza wejście i zwraca wygenerowany tekst na podstawie Twojego promptu.

Ten punkt końcowy obsługuje całą generację tekstu. Nie obsługuje embeddingów, audio ani wideo. Możesz strumieniować odpowiedzi lub czekać na pełny blok. Model obsługuje kontekst o łącznej wielkości do 100,000 tokenów.

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)

Strumieniowanie i zużycie tokenów

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. API zwraca zdarzenia wysyłane przez serwer (SSE) dla każdego wygenerowanego tokena. Pozwala to na wyświetlanie wyniku w czasie rzeczywistym. Statystyki użycia tokenów są zawarte w ostatniej cząstce strumienia. Pomaga to w dokładnym śledzeniu kosztów bez parsowania każdego indywidualnego tokena.

Strumieniowanie zmniejsza postrzeganą opóźnienie dla długich odpowiedzi. Jest idealne dla interfejsów czatu i generowania dynamicznej treści. Możesz przerwać strumień wcześniej, jeśli użytkownik przerwie generowanie.

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

Wywoływanie funkcji i tryb JSON

Korzystaj z tools parametr włączający wywoływanie funkcji. Zdefiniuj swoje funkcje w ciele żądania i pozwól modelowi wybrać, którą z nich wywołać. tool_choice parametr pozwala wymusić konkretną funkcję lub automatyczny wybór. Dla ścisłego wyjścia JSON ustaw response_format do {"type": "json_object"}. Zapewnia to, że odpowiedź jest poprawnym JSON-em.

Wywoływanie funkcji jest przydatne do ekstrakcji danych strukturalnych lub wyzwalania akcji. Tryb JSON jest idealny do integracji API wymagających przewidywalnych formatów. Połącz oba, aby uzyskać solidną logikę aplikacji.

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)

Parametry modelu i ograniczenia

Dostosuj zachowanie generowania za pomocą standardowych parametrów takich jak temperature, top_p, a także stop. Maksymalne okno kontekstowe wynosi 100 000 tokenów, w tym prompt i completion. Maksymalna liczba tokenów na żądanie to 16 000. Jeśli nie ustawisz max_tokens, limit domyślnie wynosi 2 048 tokenów.

Użyj seed dla odtwarzalnych wyników. Ustaw presence_penalty i frequency_penalty do kontrolowania powtórzeń. Te parametry dają Ci drobną kontrolę nad kreatywnością i spójnością modelu. Zawsze testuj z konkretnym przypadkiem użycia, aby znaleźć odpowiedni balans.

Limity szybkości i błędy

API narzuca limit 300 żądań na minutę i 8 równoległych żądań na klucz. Jeśli przekroczysz te limity, otrzymasz błąd 429. Błąd 401 wskazuje na nieprawidłowy lub brakujący klucz API. Błąd 402 oznacza, że Twój kredyt prepaydowy został wyczerpany.

Błędy nie zużywają Twojego kredytu. Możesz ponowić nieudane żądania bez kary. Rozmiar ciała żądania jest ograniczony do 8 MB. Zarządzaj swoją konkurencją ostrożnie, aby uniknąć throttlingu. Monitoruj swoje użycie poprzez ostatni fragment odpowiedzi strumieniowych.