Konfiguracja API MiniMax: klucz, Base URL i pierwsze zapytanie
To konfiguracja krok po kroku dla interfejsu API kompatybilnego z OpenAI na minimaxapikey.com: konto, klucz, Base URL, pierwsze zapytanie. To niezależna usługa, nie oficjalny interfejs API żadnego dostawcy modeli.
Zaktualizowano

Kluczowe punkty
- Zarejestruj się przez Google lub e-mail, a następnie odebraj $0,50 kredytu próbnego na stronie klucza. Nie jest wymagana karta.
- Base URL to https://api.minimaxapikey.com/v1, identyfikator modelu to uncensored, autoryzacja to klucz Bearer.
- Istnieją dwie metody: POST /v1/chat/completions i GET /v1/models.
- 401 oznacza błędny klucz, a 429 oznacza przekroczenie limitu, więc sprawdź kod błędu w ciele odpowiedzi.
Konfiguracja
Użytkownicy szukają konfiguracji API MiniMax, oczekując jednego z dwóch: oficjalnej platformy deweloperskiej MiniMax lub interfejsu API w stylu OpenAI. Ta strona dotyczy tego drugiego. Usługa za minimaxapikey.com to hostowany, kompatybilny z OpenAI interfejs API tekstowego, obsługujący pojedynczy model o otwartych wagach, prowadzony przez niezależnego dostawcę. Nie jest to oficjalny interfejs API MiniMax ani żadnego innego dostawcy modeli i nie przesyła zapytań między dostawcami. Jeśli potrzebujesz platformy samego dostawcy, odwiedź jego stronę.
Otrzymujesz prosty interfejs. Działa dowolny SDK lub klient OpenAI po zmianie Base URL i klucza. Dostępne są dwie metody, POST /v1/chat/completions i GET /v1/models, jeden identyfikator modelu, uncensored i okno kontekstu 100 000 tokenów dzielone między prompt a completion. Obsługuje tylko tekst, więc nie ma generowania obrazów, audio ani wideo, nie ma embeddingów ani dostrajania. Wspierane jest strumieniowanie, wywoływanie funkcji i tryb JSON.
Cała konfiguracja zajmuje kilka minut. Poniższe kroki są uporządkowane, a każdy kończy się sprawdzeniem, abyś wiedział, że zadziałało, zanim przejdziesz dalej.
Krok 1 i 2: utwórz konto i odbierz kredyt próbny
- Otwórz stronę klucza. Przejdź do strony klucza API i zaloguj się. Możesz użyć Google, adresu e-mail i hasła.
- Aktywuj kredyt próbny. Po zalogowaniu na stronie klucza znajduje się przycisk aktywacji $0,50 kredytu próbnego. Wymaga jednego kliknięcia, nie wymaga karty, jest ważny przez 7 dni i limitowany do jednego na osobę.
Kredyt próbny jest mały z założenia. Przy cenie $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, $0,50 pokrywa sporą liczbę zapytań testowych. Prompt o 1000 tokenach z odpowiedzią 500 tokenów kosztuje $0,00015 za wejście plus $0,00025 za wyjście, co daje $0,0004. Podziel $0,50 przez tę kwotę, a otrzymasz 1250 takich zapytań, więc masz dużo miejsca na eksperymenty.
Zwróć uwagę na limity klucza próbnego: 2 równoległe zapytania i 60 zapytań na minutę. Pełny klucz, który otrzymasz po doładowaniu, pozwala na 8 równoległych zapytań i 300 na minutę. Jeśli pętla testowa działa równolegle i widzisz błędy 429, to jest pierwsza rzecz do sprawdzenia.
Krok 3: utwórz klucz i przechowuj go bezpiecznie
Na tej samej stronie utwórz klucz API i skopiuj go. Traktuj go jak hasło. Umieść go w zmiennej środowiskowej lub menedżerze sekretów, nigdy w repozytorium, pakiecie front-end czy zrzucie ekranu. Jeśli klucz wycieknie, usuń go i wygeneruj ponownie.
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
Kod po stronie serwera powinien odczytywać zmienną w czasie działania. Kod przeglądarki nie powinien w ogóle przechowywać klucza: wysyłaj zapytania z backendu, ponieważ wszystko wysłane do przeglądarki jest widoczne dla każdego odwiedzającego.
Krok 4: wylistuj modele, aby potwierdzić klucz
Najtańszym możliwym testem jest endpoint modeli. Nie generuje tekstu, więc jest to czyste sprawdzenie klucza, URL i Twojej sieci.
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
Powinieneś otrzymać listę JSON z uncensored. Przy 401 klucz jest zły lub ma spacje/cudzysłów. Sprawdź, czy URL kończy się na /v1 i używasz https.
Krok 5: wyślij pierwsze zapytanie czatu
Teraz prawdziwe zapytanie o completion. Body ma standardową strukturę chat completions.
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
Odpowiedź zawiera choices[0].message.content i blok usage z liczbą tokenów prompt i completion. Sprawdź też nagłówki odpowiedzi, używając curl -i. Zobaczysz X-Request-Id, który obsługa może wykorzystać do zlokalizowania Twojego zapytania, X-Balance-USD, Twój pozostały kredyt oraz nagłówki limitu zapytań X-RateLimit-Limit-Requests i X-RateLimit-Limit-Concurrency.
Parametry temperature, top_p, stop, seed i kary są przekazywane. max_tokens jest opcjonalny. Jeśli go pominiesz, odpowiedź może wykorzystać całą pozostałą część okna.
Krok 6: to samo wywołanie z SDK
Gdy curl działa, przejdź do języka, którego faktycznie będziesz używać. Tylko dwa argumenty zmieniają się w porównaniu do standardowej konfiguracji OpenAI.
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
Dla strumieniowania dodaj stream: true i czytaj SSE. Dane użycia docierają na końcu strumienia. Dokumentacja opisuje strumieniowanie, wywoływanie funkcji i response_format: {"type":"json_object"}.
Przeniesienie istniejącego projektu OpenAI
W większości przypadków projekt, który chcesz podłączyć, już działa z biblioteką klienta OpenAI. W takim przypadku rzadko edytujesz kod. Oficjalne SDK odczytują zmienne środowiskowe OPENAI_API_KEY i OPENAI_BASE_URL, gdy nie przekazujesz argumentów, więc zmiana konfiguracji wdrożenia może wystarczyć.
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
Pozostała jedna zmiana: nazwa modelu. Ciąg znaków będący identyfikatorem modelu OpenAI nie będzie tu istniał, więc zamień go na uncensored, najlepiej poprzez wartość konfiguracyjną, abyś mógł wrócić do poprzedniego modelu. Przeczytaj następnie kod, aby sprawdzić, których funkcji usługa nie oferuje. Generowanie obrazów, audio, embeddingi i dostrajanie nie są dostępne, ponieważ jest to interfejs API czatu tylko tekstowego. Jeśli Twoja aplikacja wywołuje embeddingi do wyszukiwania, będziesz potrzebować innego dostawcy do tej części, a czat możesz zostawić na tym.
Pomoże też wiedza o modelu. To pojedynczy model o otwartych wagach, dostrojony do odpowiadania bez odmów treści dla zgodnego z prawem użytku przez dorosłych, i obowiązuje jeden twardy limit niezależnie od ustawień: brak treści seksualnych z udziałem nieletnich. Prompty napisane dla innego modelu mogą wymagać drobnych dostosowań, ponieważ każdy model reaguje inaczej na ten sam prompt systemowy. Uruchom własne testowe prompty obok siebie przed przełączeniem ruchu produkcyjnego.
Ustawienia warte wyboru od pierwszego dnia
Kilka decyzji łatwiej podjąć w czasie konfiguracji niż po uruchomieniu. Żadna z nich nie jest trudna, ale każda unika niespodzianki później.
- Prompt systemowy. Wpisz instrukcje dotyczące tonu, formatu i roli w wiadomości
system. Zachowaj zwięzłość i konkret, bo każde zapytanie powtarza ją jako tokeny wejściowe. - Limit tokenów.
max_tokensjest opcjonalny, ale limit to tani środek ostrożności. Bez niego jedna odpowiedź może zużyć resztę okna 100 000 tokenów. - Strumieniowanie dla interakcji. Ustaw
stream: true, gdy ktoś czeka na odpowiedź. Dla zadań wsadowych zwykłe zapytania są prostsze. - Zasada ponawiania dla 429. Traktuj 429 jako sygnał do poczekania, a nie jako błąd. Gdy odpowiedź zawiera
Retry-After: 5, uśpienie na ten czas i ponowienie zapytania jest właściwym ruchem. - Rozmiar zapytania. Limit rozmiaru body to 8 MB. To znacznie więcej niż potrzebuje normalny prompt, ale wklejone logi lub dokumenty mogą to osiągnąć.
Prompty nie są używane do trenowania, co ma znaczenie, jeśli planujesz wysyłać dokumenty wewnętrzne lub wiadomości użytkowników. To Ty ponosisz odpowiedzialność za to, co wyślesz, więc unikaj umieszczania sekretów, których model nie potrzebuje, w prompcie.
Doładowanie po kredycie próbnym
Kredyt próbny służy do sprawdzenia, czy wszystko działa. Kiedy będziesz gotowy do budowania, dodaj przedpłacony kredyt. Nie ma subskrypcji: płacisz za użyte tokeny, po $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, a kredyt nigdy nie wygasa, więc niewykorzystane saldo nie znika na koniec miesiąca.
Działa dowolna kwota całkowita od $20 do $500. Doładowanie $50 dodaje bonus 5%, $100 dodaje 10%, a $200 dodaje 15%. Jako szybki przykład, doładowanie $100 z bonusem 10% daje $110 kredytu. Przy prompcie 1000 tokenów i odpowiedzi 500 tokenów z kroku drugiego każde zapytanie kosztuje $0,0004, więc $110 pokrywa 275 000 zapytań. Rzeczywiste prompty są zwykle dłuższe, więc skaluj tę liczbę do własnej średniej.
Naprawa typowych błędów konfiguracji
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 401 przy każdym wywołaniu | Brakujący, błędnie wpisany lub unieważniony klucz | Wyślij Authorization: Bearer <key>, bez dodatkowych cudzysłowów |
| 404 lub odpowiedź HTML | Zła ścieżka, zwykle brak /v1 | Użyj pełnego Base URL kończącego się na /v1 |
| Model nie znaleziony | Nazwa modelu skopiowana z innego dostawcy | Użyj uncensored |
429 z rate_limited | Przekroczenie limitu zapytań na minutę | Zwolnij tempo lub doładuj, aby przejść z limitów próbnych na pełne limity |
429 z concurrency | Zbyt wiele zapytań naraz | Ogranicz równoległe wywołania do 8 (2 na kluczu próbnym) |
429 z Retry-After: 5 | Tymczasowe przeciążenie | Poczekaj 5 sekund i ponów |
| 413 lub odrzucone body | Zapytanie przekracza 8 MB | Skróć prompt lub podziel zadanie |
Gdy będziesz gotowy na więcej niż kredyt próbny, strona cennika wymienia opcje doładowania: dowolną kwotę całkowitą od $20 do $500, płatną kryptowalutami (USDT na TRC20, USDC na Base), z bonusem 5% od $50, 10% od $100 i 15% od $200. Nieudane lub odrzucone zapytania nie są rozliczane, a prompty nie są używane do trenowania modeli.
Więcej przewodników
Pytania i odpowiedzi
Czy to oficjalne API MiniMax?
Nie. Jest to niezależny, hostowany interfejs API kompatybilny z OpenAI, obsługujący jeden model o otwartych wagach, dostrojony do odpowiadania bez odmów treści dla zgodnego z prawem użytku przez osoby dorosłe. Nie jest to oficjalny interfejs API żadnego dostawcy modeli ani router łączący wielu dostawców.
Czy potrzebuję karty kredytowej, aby wypróbować?
Nie. Po rejestracji możesz odebrać $0,50 kredytu próbnego jednym kliknięciem na stronie klucza API. Jest ważny przez 7 dni i jest ograniczony do jednego na osobę.
Jaka jest nazwa modelu do użycia w zapytaniach?
Użyj uncensored. Usługa udostępnia ten pojedynczy identyfikator modelu, a GET /v1/models go wyświetli.
Jak dodać więcej kredytu później?
Doładuj dowolną kwotę w pełnych dolarach od $20 do $500. Bonusy naliczane są od $50 (+5%), $100 (+10%) i $200 (+15%), a kredyt nigdy nie wygasa.
Czy mogę użyć SDK OpenAI?
Tak. Ustaw base_url na https://api.minimaxapikey.com/v1, użyj swojego klucza i wyślij model uncensored. Nic innego w Twoim kodzie nie musi się zmienić.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień Base URL. To cała konfiguracja.