Wprowadzenie
API MiniMax M3.1 Flash łączy 1 000 000 tokenów wejściowych z rozumieniem obrazów i wideo dla agentów programistycznych; przez reasoning_effort reguluje się głębokość rozumowania bez zmiany modelu. W M3.1 Flash odczytuje się image_url i video_url obok tekstu oraz zwraca tekst; dla tego endpointu nie przyjmuje się audio, a wideo trzeba osadzić w łącznym limicie platformy 14 MB.
Najważniejsze funkcje
W M3.1 Flash rozumowanie działa zawsze z low, medium, high, xhigh lub domyślnym max; nie udostępnia się tu temperature ani top_p i nie przyjmuje none. Zarezerwuj w max_tokens wspólny budżet rozumowania M3.1 Flash i widocznej odpowiedzi: domyślnie 4096, maksymalnie 524288; stop przyjmuje cztery sekwencje po najwyżej 32 znaki. W M3.1 Flash dopuszcza się do 256 wiadomości i 128 definicji narzędzi na żądanie; obrazy zużywają tokeny wejściowe i dzielą budżet z historią rozmowy.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
messages | Tak | Ułóż historię M3.1 Flash kolejno, z mediami i pełnymi wymianami asystenta z narzędziami; wideo osadź do 14 MB, bez części audio dla tego endpointu. od 1 elementów · do 256 elementów |
max_tokens | Nie | Ogranicz łącznie rozumowanie i widoczną odpowiedź M3.1 Flash: domyślnie 4096, maksymalnie 524288; mały budżet może się skończyć przed tekstem. |
reasoning_effort | Nie | Dla M3.1 Flash wybierz low, medium, high, xhigh lub domyślne max; rozumowanie pozostaje aktywne, a większy wysiłek może zużyć więcej tokenów wyjściowych i czasu. |
stop | Nie | Zakończ odpowiedź M3.1 Flash na zgodnej sekwencji, pomijanej w zwracanym tekście; użyj jednego ciągu lub maksymalnie czterech po najwyżej 32 znaki. od 1 znaków · od 1 elementów · do 4 elementów |
tools | Nie | Udostępnij M3.1 Flash do 128 definicji funkcji w formacie OpenAI; sprecyzuj schemat argumentów, ponieważ funkcje wykonuje twoja aplikacja. do 128 elementów |
parallel_tool_calls | Nie | Zezwól M3.1 Flash proponować niezależne wywołania razem i zachowaj każdy identyfikator przy odsyłaniu oddzielnych wyników wykonania. Domyślnie: |
tool_choice | Nie | Steruj wyborem narzędzi M3.1 Flash przez auto, none, required lub nazwaną funkcję; none wyłącza tu wybór narzędzi, a nie rozumowanie. |
response_format | Nie | Zażądaj tekstu lub struktury JSON od M3.1 Flash i sprawdź obiekt przed użyciem w diagnostyce albo jako wejścia wykonywanej operacji. |
Cennik
Wejście $0.15 / Wyjście $0.60 za 1 mln tokenów
Zastosowania
W tym przykładzie M3.1 Flash prosi się o kolejne wywołania diagnostyczne; sprawdź, czy każda proponowana czynność wynika z przesłanych dowodów problemu. W pętlach narzędzi M3.1 Flash zachowaj pełną odpowiedź asystenta z rozumowaniem i wywołaniami, a wyniki odeślij z właściwym tool_call_id; walidację i wykonanie zapewnia twoja aplikacja.
Wskazówki
W M3.1 Flash mierzy się oddzielnie wejście, wejście z pamięci podręcznej i wyjście; obrazy oraz wideo liczy się na wejściu, a rozumowanie w budżecie wyjścia, według stawek widocznych tutaj. SpicyAPI nie dodaje własnego filtra do M3.1 Flash; odpowiedź zależy od modelu, a multimedia i głębsze rozumowanie nie gwarantują wyniku NSFW.
minimax/m3.1-flash/chat
Szybki start z API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "minimax/m3.1-flash/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
