API MiniMax: pierwsze zapytanie w pięć minut

Zainstaluj SDK OpenAI

Zacznij od zainstalowania oficjalnego SDK OpenAI dla wybranego języka. Biblioteka automatycznie formatuje zapytania i obsługuje strumieniowanie. Upewnij się, że masz zainstalowany Python 3.8+ lub Node.js 18+. Uruchom pip install openai dla Pythona lub npm install openai dla Node. SDK upraszcza interakcję z endpointem /v1/chat/completions. Zarządza nagłówkami, ponownymi próbami i parsowaniem SSE, dzięki czemu możesz skupić się na promptcie. Działa to, ponieważ nasze API jest zgodne ze standardem chat completions OpenAI. Nie potrzebujesz własnej biblioteki klienckiej. Standardowe metody SDK mapują się bezpośrednio na nasze endpointy. Skraca to czas integracji i wykorzystuje istotną wiedzę deweloperów.

Skonfiguruj URL podstawowy i klucz

Ustaw swój klucz API i base URL w zmiennych środowiskowych. Nasz base URL to https://api.minimaxapikey.com/v1. Pozwala to na użycie standardowych klientów OpenAI bez modyfikacji. Utwórz konto, aby wygenerować klucz. Klucz jest wyświetlany natychmiast po rejestracji. Nie jest potrzebna karta. Przechowuj klucz bezpiecznie. Przekaż go jako nagłówek lub zmienną środowiskową. SDK domyślnie używa OPENAI_API_KEY. Możesz nadpisać base URL, aby wskazywał na nasze serwery. Zapewnia to, że wszystkie zapytania trafiają do modelu bez cenzury. Zweryfikuj działanie klucza prostym pingiem. Ten krok zapobiega błędom uwierzytelniania później.

Wyślij podstawowe uzupełnienie czatu

Wyślij pierwsze zapytanie, aby wygenerować tekst. Użyj metody POST na /v1/chat/completions. Określ model jako uncensored. Przekaż tablicę wiadomości z promptem użytkownika. API zwraca token uzupełnienia. To jest główna funkcja generowania tekstu. Obsługuje okno kontekstu 100k. Możesz wysyłać długie promptty lub historię rozmów. Odpowiedź zawiera wygenerowany tekst i zużycie tokenów. Jest to idealne do pisania kreatywnego lub nieograniczonej rozmowy. Upewnij się, że treść jest prawna. Model nie odrzuca tematów dla dorosłych. Blokuje tylko treści seksualne z udziałem małoletnich. Zacznij od prostego testu, aby zweryfikować połączenie.

Włącz strumieniowanie (SSE)

Aby uzyskać wynik w czasie rzeczywistym, włącz strumieniowanie. Ustaw parametr stream na true. API zwraca zdarzenia typu Server-Sent Events (SSE). Każdy fragment zawiera część odpowiedzi. Zmniejsza to postrzeganą latencję. Użytkownicy widzą tekst pojawiający się w miarę jego generowania. SDK automatycznie parsuje fragmenty. Możesz wyświetlać tekst stopniowo w interfejsie użytkownika. Jest to kluczowe dla interfejsów czatu. Strumieniowanie działa z odpowiedziami wszystkich modeli. Nie wpływa na liczenie tokenów. Każdy fragment zawiera dane użycia na końcu. Wykorzystaj to dla lepszych wrażeń użytkownika. Działa to bardziej responsywnie niż oczekiwanie na pełną odpowiedź. Skonfiguruj swojego klienta tak, aby poprawnie buforował fragmenty.

Użyj wywoływania funkcji

Wsparcie dla wyjść strukturalnych z wywoływaniem funkcji. Zdefiniuj narzędzia w ciele zapytania. Model może wywoływać funkcje na podstawie promptu. To umożliwia integrację z systemami zewnętrznymi. Przekaż definicje narzędzi i wiadomości użytkownika. Odpowiedź zawiera obiekt wywołania narzędzia. Wykonaj funkcję i przekaż wyniki z powrotem. To działa ze standardowymi SDK OpenAI. Pozwala na złożone przepływy pracy. Możesz budować agentów lub asystentów. Model utrzymuje kontekst między wywołaniami. To jest potężne do automatyzacji. Upewnij się, że definicje narzędzi są precyzyjne. API obsługuje trasowanie wyjść narzędzi. Utrzymuje spójność rozmowy. Użyj tego do generowania dynamicznej treści.

Sprawdź dostępne modele

Zweryfikuj listę modeli przez GET /v1/models. Ten endpoint zwraca dostępne modele. Nasze API obsługuje jeden model: uncensored. Jest to model o otwartych wagach. Nie jest to GPT, Claude ani Gemini. Odpowiedź potwierdza identyfikator modelu. Użyj tego do debugowania konfiguracji klienta. Upewnij się, że twój kod kieruje się do właściwego modelu. Endpoint jest szybki i niezawodny. Zwraca dane JSON. Możesz je sparsować do wyświetlania w UI. Potwierdza, że twój klucz API jest ważny. Użyj tego do zautomatyzowanych testów zdrowia. Jest częścią standardu OpenAI. Nie jest potrzebna dodatkowa konfiguracja. Zapewnia to kompatybilność z istniejącymi narzędziami.

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Strumieniowanie

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)