MiniMax H3 Max Turbo

Twórz wideo 5–15 sekund w 480P lub 768P z tekstu albo pierwszej i ostatniej klatki. Pola żądania, limity obrazów, cena za sekundy wyniku i odpytywanie zadań.

MiniMax H3 Max Turbo generuje krótkie wideo z tekstu lub obrazów klatek. Użyj ID modelu minimax-h3-max-turbo, zachowaj zwrócony identyfikator zadania i odpytuj je, aby pobrać gotowe wideo. Ta strona opisuje natywny interfejs z tablicą content oferowany w SeedRouter.

ID modeli

ID modelu	Wejście	Rozdzielczości	Długość
`minimax-h3-max-turbo`	tekst, pierwsza klatka, opcjonalna ostatnia klatka	480P, 768P	5–15 sekund

Aktualne ceny znajdziesz na stronie modelu.

Krótki przykład

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Punkt końcowy

POST https://api.seedrouter.ai/v1/videos/generations

Nagłówek	Wartość
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowe wideo. Odpytuj GET /v1/tasks/{task_id}, aby uzyskać wynik. Przechowuj klucze API w kodzie po stronie serwera.

Parametry

Pole	Typ	Domyślnie	Uwagi
`model`	string	wymagane	`minimax-h3-max-turbo`
`content`	array	wymagane	Prompt i multimedia jako elementy opisane poniżej. Dokładnie jeden niepusty element `text`.
`resolution`	enum	wymagane	`480P` lub `768P`.
`duration`	integer	wymagane	Dowolna liczba całkowita od 5 do 15 sekund.
`ratio`	enum	według wejścia	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Wymagane dla samego tekstu, gdy `adaptive` nie jest przyjmowane.
`extra`	object	pominięte	Opcjonalne ustawienia rozwijania promptu.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled`, `balanced` lub `quality`. Pominięcie obiektu lub właściwości zachowuje domyślną wartość modelu.
`content_filter`	boolean	`true`	Filtr treści SeedRouter opisany poniżej. Nie jest wysyłany do modelu.

Schemat jest ścisły: nieznane pola są odrzucane, a nie ignorowane. callback_url jest niedostępne; zamiast niego odpytuj zadanie. extra to opcjonalny ścisły obiekt zawierający tylko prompt_expansion_mode. Wszystkie pola odrzucają null; zamiast tego pomijaj pola opcjonalne.

Elementy content

`type`	Element	`role`
`text`	`{"type":"text","text":"..."}`, do 7000 znaków	brak
`image_url`	`{"type":"image_url","image_url":{"url":"https://..."},"role":"first_frame"}`	`first_frame` lub `last_frame`

Wymagany jest dokładnie jeden niepusty element tekstowy. Pojedynczy obraz bez roli jest traktowany jako pierwsza klatka. Przyjmowana jest najwyżej jedna pierwsza i jedna ostatnia klatka; ostatnia wymaga pierwszej. Obrazy, wideo i audio referencyjne nie są obsługiwane.

Tryby

Elementy w content wyznaczają tryb; pole mode nie jest wysyłane.

Tryb	Treść	Proporcje
Tekst na wideo	jeden element tekstowy	wymagane; jedne z sześciu konkretnych proporcji, nigdy `adaptive`
Obraz na wideo	tekst i pierwsza klatka, opcjonalnie ostatnia	według obrazów klatek; inna poprawna wartość nie ma wpływu

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Obrazy klatek

Używaj publicznych URL-i HTTP(S) bez osadzonych danych logowania. Base64 i identyfikatory mm_file:// nie są przyjmowane. Obrazy mogą mieć format JPG, JPEG, PNG, WebP, HEIC lub HEIF, rozmiar do 30 MB każdy, każdy bok 256–5760 pikseli oraz stosunek szerokości do wysokości od 0,4 do 2,5. Wejście jest sprawdzane przed generowaniem. Dla dwóch klatek użyj dopasowanych kompozycji i proporcji.

Filtr treści

content_filter ma wartość true, chyba że ustawisz inną. Gdy filtr jest włączony, żądanie, jego tekst i multimedia są moderowane przed generowaniem. Oznaczone żądanie kończy się niepowodzeniem z kodem 60001 i nie jest płatne. Ustaw content_filter na false, aby pominąć moderację; Playground na stronie zawsze pozostawia ją włączoną.

Czynniki wpływające na koszt

Sekcja cennika modelu pokazuje aktualne stawki. Turbo ma jedną opłatę: sekundy wyniku w wybranej rozdzielczości. Pierwsza i ostatnia klatka oraz rozwijanie promptu nie mają osobnej opłaty.

cost = reported output seconds × output-second rate for the resolution

Szacunek używa żądanych pełnych sekund. Końcowe rozliczenie wykorzystuje zgłoszone sekundy wyniku zakończonego zadania według stawki zapisanej dla żądania. Jeśli poprawne zużycie jest niedostępne, stosowany jest przyjęty szacunek. Długość kontenera multimedialnego może nieznacznie różnić się od płatnych sekund. Opłaty sprawdzisz w historii zużycia konta; publiczne odpowiedzi zadań nie zawierają kosztów. Nieudane zadania nie są płatne.

Schemat odpowiedzi

Wysłanie żądania zwraca zadanie:

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

Pobieranie zadania

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Odpytuj co 10–20 sekund, aż status wyniesie completed lub failed. Limit czasu sieci podczas odpytywania nie oznacza nieudanego generowania: zachowaj identyfikator zadania i wznów sprawdzanie. Nie twórz kolejnego zadania, aby sprawdzić postęp.

Zadanie zakończone

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio to proporcje, w których utworzono klip, w tym proporcje wybrane dla adaptive. Zadanie zawiera rzeczywistą rozdzielczość, proporcje i długość, jeśli zostały zgłoszone. JSON powyżej ilustruje strukturę odpowiedzi; nie jest zmierzonym wynikiem generowania.

Błędy

Żądania odrzucone przed utworzeniem zadania zwracają błąd HTTP z obiektem error i nie są płatne. Zadanie, które nie powiedzie się po przyjęciu, przy odpytywaniu zwraca HTTP 200 z polem status: "failed" i obiektem error.

Kody, statusy HTTP i wskazówki dotyczące ponawiania znajdziesz we wspólnym katalogu błędów.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Jeśli limit czasu upłynie podczas samego wysyłania, sprawdź zadania przed ponowną wysyłką: pierwsze żądanie mogło zostać przyjęte.

Wskazówki

Opisz jeden obiekt, akcję, ruch kamery i układ światła na ujęcie.
Użyj 480P na szkic i 768P dla większej szczegółowości wyniku. Każde nowe generowanie to osobne płatne żądanie.
Podaj pierwszą klatkę, aby ustalić kompozycję otwierającą; ostatnią dodaj tylko wtedy, gdy podajesz też pierwszą.
Użyj extra.prompt_expansion_mode, aby wybrać disabled, balanced lub quality; pominięcie zachowuje balanced.
Sprawdź cały klip i jego dźwięk przed publikacją. Prompt nie gwarantuje dokładnej geometrii produktu ani napisów.

Powiązane

Zakres specyfikacji

Ten interfejs używa formatu żądań MiniMax z tablicą content, ID modeli SeedRouter, zadań asynchronicznych, obrazów tylko przez URL i dostarczania hostowanych wyników. Wywołania zwrotne i anulowanie są niedostępne. content_filter to kontrola wejścia SeedRouter, a nie parametr MiniMax.

Osobny interfejs hostowany przez fal ma inne pola i limity; jego 1080P, ułamkowe długości, ustawienia docelowego audio i uporządkowanych referencji nie mają tu zastosowania. Ten interfejs nie przyjmuje ustawień seed ani znaku wodnego. Rozróżnienie i źródła znajdziesz w poradniku porównawczym.

On this page