MiniMax M3.1 Flash

Użyj dokładnego identyfikatora modelu MiniMax-M3.1-Flash. Na stronie modelu znajdziesz Playground i aktualne ceny. Specyfikacja OpenAPI definiuje zagnieżdżone pola żądań i odpowiedzi.

Szybki start

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

Ten przykład ustawia limit wyjścia; nie jest to domyślna wartość modelu. Przechowuj klucze na swoim serwerze. Playground używa konta, na którym jesteś zalogowany, i nie wymaga wklejania klucza API.

Formaty i uwierzytelnianie

Wyślij Content-Type: application/json oraz Authorization: Bearer $SEEDROUTER_API_KEY. Messages akceptuje też x-api-key; klienty SDK mogą dołączać anthropic-version: 2023-06-01. Formaty te zachowują natywną treść żądań i strukturę odpowiedzi.

Parametry

Wszystkie pola poza wymienionymi wyżej polami wymaganymi są opcjonalne. Pominięcie pola różni się od jawnego przekazania null: pole akceptuje null tylko wtedy, gdy deklaruje to OpenAPI. Nieobsługiwane pola najwyższego poziomu są odrzucane; nieprawidłowe wartości obsługiwanych pól powodują błąd.

Chat Completions

Messages

Responses

Playground ustala model i udostępnia wszystkie pozostałe pola: 12 kontrolek dla Chat, 11 dla Messages i 12 dla Responses. Zagnieżdżone obiekty i pełne historie rozmów wprowadzasz w polach JSON. Nieprawidłowe wartości obsługiwanych pól blokują wysłanie w przeglądarce.

Rozumowanie i limity

Udokumentowane okno kontekstu wynosi 1 000 000 tokenów. Limit wyjścia to 524 288 tokenów, łącznie z rozumowaniem. MiniMax zaleca 131 072 tokeny wyjściowe do wymagających zadań, ale nie określa tej wartości jako domyślnej.

Tryb myślenia jest zawsze włączony. Ten model nie obsługuje ustawień myślenia disabled, none ani minimal. Niewielki budżet wyjściowy może się wyczerpać, zanim pojawi się tekst odpowiedzi. Ten kontrakt API nie obsługuje service_tier, wejścia audio ani ustrukturyzowanego wyjścia JSON.

Cała treść żądania nie może przekraczać 64 MB. Usługa modelu sprawdza dokładne wykorzystanie kontekstu i zawartość zdalnych mediów.

Obrazy i wideo

Chat używa bloków treści image_url: {"url":"..."} i video_url: {"url":"..."}. Messages używa bloków obrazu/wideo z obiektem source: {"type":"url","url":"..."} lub {"type":"base64","media_type":"...","data":"..."}. Responses używa input_image lub input_video, których wartość URL może być ciągiem znaków lub obsługiwanym obiektem opcji.

detail akceptuje low, default, high; wartość domyślna to default. W przypadku wideo fps mieści się w zakresie od 0.2 do 5, domyślnie 1. Opcjonalne pole max_long_side_pixel, jeśli występuje w zagnieżdżonym schemacie, musi być dodatnią liczbą całkowitą.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

Zastąp przykładowy URL adresem własnego dostępnego pliku. Dane osadzone używają odpowiedniego typu MIME base64; dla MOV jest to video/mov. Istniejące odwołania do wideo mm_file:// są przekazywane bez zmian, ale usługa nie udostępnia API przesyłania plików Files. Konto przetwarzające żądanie nadal musi mieć dostęp do tego odwołania.

Narzędzia i historia rozmowy

Narzędzia funkcyjne opisują działania, które może wykonać twoja aplikacja. Wywołanie narzędzia nie dowodzi, że wykonano działanie zewnętrzne: sprawdź nazwę i argumenty, wykonaj działanie w aplikacji, a następnie zwróć wynik z pasującym identyfikatorem wywołania.

Kontynuując rozmowę w Chat, zachowaj pełną wiadomość assistant, w tym reasoning_content i tool_calls; wiadomości narzędzi wymagają tool_call_id. W Messages zachowaj bloki myślenia, podpisy oraz bloki tool_use i tool_result. W Responses dodaj wszystkie zwrócone elementy wyjściowe przed następnym wejściem użytkownika.

Nie sprowadzaj tych historii do samego tekstu odpowiedzi. Dowolne schematy parametrów funkcji i przekazywane z powrotem pola rozumowania są zachowywane. Oficjalna dokumentacja referencyjna Chat nie definiuje parametru tool_choice dla tego modelu.

Streaming i pola odpowiedzi

Ustaw stream: true, aby odbierać zdarzenia wysyłane przez serwer. Chat emituje choices[].delta i kończy przez [DONE]; podaj stream_options: {"include_usage":true}, aby otrzymać dane o użyciu. Messages emituje nazwane zdarzenia, takie jak message_start, aktualizacje bloków treści i message_stop. Responses emituje zdarzenia takie jak response.output_text.delta i response.completed.

Bez streamingu Chat zwraca choices[].message, finish_reason i usage. Messages zwraca bloki treści, stop_reason i dane o użyciu. Responses zwraca elementy output, status i dane o użyciu. Zachowaj pełną odpowiedź, jeśli aplikacja potrzebuje czegoś więcej niż wyświetlana odpowiedź.

Użycie i aktualne ceny

Tabela aktualnych cen pokazuje oba przedziały wejścia. Łączne wejście do 512 000 tokenów włącznie korzysta z pierwszego przedziału; powyżej 512 000 obowiązuje drugi. Wybrany przedział określa cenę całego żądania, w tym wyjścia i cache.

Tokeny odczytu i zapisu cache nie są ponownie rozliczane jako zwykłe wejście. Automatyczny cache sprawdza kwalifikujące się powtarzające prefiksy o długości co najmniej 512 tokenów; trafienia w cache nie są gwarantowane. Jawny znacznik cache nie jest wymagany.

Odpowiedzi zawierają liczbę tokenów, a nie kwoty pieniężne. Końcowe opłaty znajdziesz w historii użycia konta. Nieudane żądania nie są płatne.

Błędy

W razie błędu sprawdź nieprawidłowe pole i publiczną dokumentację błędów. Ten sam identyfikator modelu obsługuje trzy powyższe endpointy tekstowe; nie jest przeznaczony do endpointów embeddingów ani Gemini.

Oficjalne źródła

• Wywoływanie modeli MiniMax
• Dokumentacja referencyjna Chat Completions
• Dokumentacja referencyjna Messages
• Dokumentacja referencyjna Responses
• Kontynuacja po wywołaniu funkcji
• Automatyczny cache promptów