MiniMax H3 Max

MiniMax H3 Max to szybciej generujący wariant MiniMax H3. Jedno żądanie tworzy obraz i dźwięk razem: 5–15-sekundowy klip w 480P lub 768P z własnymi dialogami, tłem i efektami. Treść żądania ma oficjalny format MiniMax z ID modelu minimax-h3-max. Wyślij je, zachowaj zwrócony identyfikator zadania i pobierz gotowe wideo z zadania. Klatki i referencje są przesyłane jako URL-e.

ID modeli

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",
    "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

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

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

Pojedynczy obraz bez role jest pierwszą klatką. Przy więcej niż jednym obrazie każdy wymaga role.

Tryby

Elementy w content wyznaczają tryb; nie ma osobnego pola trybu.

Klatek i referencji nie można łączyć w jednym żądaniu. Oficjalna dokumentacja wymienia wejście z samą ostatnią klatką, ale zawiera też sprzeczny wymóg połączenia jej z pierwszą. Ten przypadek nie został zweryfikowany w SeedRouter. Gdy potrzebujesz obrazu końcowego, użyj obu klatek.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

Dane wejściowe multimediów

Każdy element obrazu, wideo i audio jest publicznym adresem URL HTTP(S). Identyfikatory mm_file:// i identyfikatory URI danych Base64 nie są przyjmowane: prześlij plik do własnego magazynu i podaj jego URL.

Wideo referencyjne jest mierzone w chwili przyjęcia żądania; gdy nie da się odczytać długości, jest odrzucane bez opłaty. Pozostałe limity są sprawdzane przed generowaniem, a naruszające je żądanie kończy się niepowodzeniem bez opłaty.

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

Sprawdź aktualne stawki w sekcji cennika modelu. MiniMax H3 Max osobno wycenia wygenerowane sekundy wyjściowe i sekundy wideo referencyjnego według rozdzielczości wyniku. Pierwsze dwa obrazy są bezpłatne; każdy kolejny dodaje opłatę.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

Długości wideo referencyjnych są sumowane i zaokrąglane do najbliższej pełnej sekundy przy ostatecznym zużyciu. Dwa klipy po 2,4 sekundy dają więc pięć sekund wejściowych. Audio referencyjne nie ma opłaty wejściowej. Pierwsza i ostatnia klatka liczą się jako obrazy, więc same dwie klatki nie dodają opłaty za obrazy.

Szacunek Playgroundu zaokrągla długości wideo referencyjnych w górę, aby pokryć możliwą końcową opłatę. Ostateczne zużycie jest wyceniane według stawki zapisanej dla żądania. Jeśli pełny raport zużycia jest niedostępny, stosowany jest przyjęty szacunek. 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", "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",
  "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",
  "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

• Opisuj ujęcie i jego dźwięk razem: obiekt, miejsce, kamerę, światło, dialogi i efekty.
• Wpisz dialog do promptu i dołącz klip audio referencyjnego, gdy głos ma go naśladować.
• Zrób szkic w 480P, a potem wybierz 768P, gdy potrzebujesz więcej szczegółów. Nowy render to osobne płatne żądanie.
• Użyj extra: {"prompt_expansion_mode": "disabled"} dla już pełnego promptu lub wybierz rozwijanie balanced / quality.
• Użyj pierwszej i ostatniej klatki do kontrolowania początku i końca ujęcia; użyj referencji do zachowania produktu, osoby lub ruchu.
• Dodaj no text, no logos, aby uniknąć zmyślonych znaków.

Powiązane

• Playground i cennik MiniMax H3 Max
• Pobierz OpenAPI
• Markdown do skopiowania

Źródła specyfikacji

Parametry są zgodne z dokumentacją generowania wideo MiniMax. SeedRouter używa własnego ID modelu i asynchronicznego interfejsu zadań, multimediów tylko przez URL oraz dostarczania hostowanego wyniku; wywołania zwrotne i anulowanie są niedostępne. content_filter to rozszerzenie SeedRouter.