{ "aboutHtml": "

Szybki wariant H3 po dodatkowym treningu

MiniMax H3 Max to wariant bazowego modelu MiniMax H3 po dodatkowym treningu, zoptymalizowany pod kątem szybszego generowania, zgodności z promptem i jakości audiowizualnej. Wariant opracowano przez dodatkowy trening w fal Research. Zachowuje wspólny kontekst multimodalny oraz natywnie zsynchronizowany obraz i dźwięk. Szybkość jest priorytetem projektowym, a nie stałym czasem wykonania dla każdego promptu, czasu trwania czy zastosowania.

Odróżniaj Max od pierwotnego systemu H3 i osobnego wariantu Max Turbo. Obecny interfejs MiniMax podaje dla Max rozdzielczość 480P lub 768P, domyślnie 768P, 24 klatki na sekundę oraz całkowitą liczbę sekund od 5 do 15. Udokumentowany proces Max nie oferuje ustawienia 2K pierwotnego systemu H3 ani czterosekundowego wyniku.

Od promptu do ujęcia

Każde generowanie zawiera niepusty opis tekstowy, do 7000 znaków na element tekstowy. Opisz temat, kompozycję początkową, akcję i rezultat, a następnie jasno określ pracę kamery i dźwięk. Przy krótkim odsłonięciu przedmiotu wskaż, co widz ma zobaczyć najpierw, jak przedmiot pojawia się w kadrze i jak ujęcie powinno się zakończyć.

Przydatny pięciosekundowy opis może przedstawiać ceramiczną filiżankę na drewnianym stole, dłoń stawiającą obok spodek, niewielki najazd kamery i odgłos zetknięcia ceramiki z drewnem. Ogranicz akcję tak, aby mieściła się w wybranym czasie, i sprawdź, czy zwrócony ruch i dźwięk dotyczą tego samego zdarzenia.

Tworzenie na podstawie klatek

Producent dokumentuje klatkę początkową, końcową lub obie. Pierwszy obraz określa początek klipu, a ostatni — końcowy stan wizualny. Wyjaśnij łączący je ruch, w tym zmiany pozy, położenia przedmiotów, kamery lub oświetlenia. Przy przejściu między dwiema klatkami unikaj opisu wprowadzającego między nimi niepasującą scenę.

Wynik oparty na klatkach przyjmuje proporcje obrazu wejściowego. Do pracy wyłącznie z tekstem wybierz konkretne proporcje: 21:9, 16:9, 4:3, 1:1, 3:4 lub 9:16. Praca z referencjami może korzystać z proporcji adaptacyjnych lub jednej z udokumentowanych wartości. Skomponuj referencję lub opisaną scenę dla docelowego kadru, zamiast zakładać, że ten sam układ równie dobrze sprawdzi się w pionie i poziomie.

Referencje multimodalne

Obecny schemat generowania Max w MiniMax dokumentuje także referencyjne obrazy, filmy i dźwięk. Określ, na co każdy z nich ma wpływać: tożsamość postaci, otoczenie, wzorzec ruchu, tor kamery, barwę głosu lub cechę dźwięku. W tym interfejsie role pierwszej i ostatniej klatki wykluczają się z rolami mediów referencyjnych.

W ujęciu postaci osobno wskaż referencję wyglądu i referencję ruchu, a następnie podaj docelową akcję oraz wypowiadaną kwestię. Referencja głosu określająca sposób wypowiedzi różni się od kopiowania całego jej sygnału audio. Jasno opisz cechy do zachowania i zmiany do wprowadzenia oraz porównaj rzeczywisty klip audiowizualny z każdą rolą referencji.

Rozwijanie promptu

Ustawienie rozwijania właściwe dla Max oferuje opcje disabled, balanced i quality, z domyślną wartością balanced. Wybierz disabled, gdy dostarczony opis ma zostać przekazany bez rozwijania; użyj udokumentowanego trybu rozwijania, gdy pożądana jest dodatkowa interpretacja. Zachowaj oryginalny opis, aby odróżnić zmianę wprowadzoną podczas rozwijania od treści, o którą proszono.

Opisuj dźwięk jako część sceny. Wskaż dźwięki fizyczne, odgłosy otoczenia i wszystkie wypowiadane słowa oraz oddziel je od muzyki w tle słyszalnej tylko dla widzów. Podaj dokładną kwestię i zamierzonego mówcę, zamiast prosić o nieokreślony dialog. Nie tylko obejrzyj wynik, lecz także go odsłuchaj; przekonujący obraz nie potwierdza poprawnego brzmienia słów ani ich czasu.

Przygotowanie danych wejściowych i limity

Obecny schemat producenta przyjmuje obrazy JPG, JPEG, PNG, WebP, HEIC lub HEIF, do 30 MB każdy, z bokami od 256 do 5760 pikseli i proporcjami od 0.4 do 2.5. Role początku i końca dopuszczają po jednym obrazie, a tryb referencyjny — maksymalnie dziewięć obrazów. Zachowaj czytelny widok tematu i szczegółów, które muszą pozostać rozpoznawalne.

Referencje wideo dopuszczają maksymalnie trzy klipy MP4 lub MOV, każdy o długości 2–15 sekund, łącznie najwyżej 15 sekund, z limitem 50 MB na plik. Dokumentacja podaje wideo H.264 lub H.265, dźwięk AAC lub MP3, boki od 256 do 5760 pikseli, proporcje od 0.4 do 2.5 i liczbę klatek od 23.976 do 60 na sekundę. Referencje dźwiękowe dopuszczają maksymalnie trzy klipy WAV lub MP3, każdy do 15 MB i o długości 2–15 sekund, łącznie najwyżej 15 sekund. Treść żądania ma osobny limit 64 MB.

Używaj tylko referencji, które wnoszą coś do ujęcia, i opisz wkład każdej z nich w tekście. Krótki, trafny klip ruchu łatwiej wykorzystać jako wskazówkę niż długi zbiór niepowiązanych zdarzeń. Jasno określ zamierzony czas trwania i rozdzielczość wyjściową, aby można było porównać wynik z tym samym opisem.

Gotowy rezultat

Asynchroniczny proces producenta zwraca identyfikator zadania, zanim gotowy film stanie się dostępny. Interfejs odpytywania zadań pobiera zadania z poprzednich siedmiu dni. Zapisz rzeczywisty zwrócony klip i jego specyfikację do montażu lub dalszej oceny; identyfikator zadania nie jest materiałem audiowizualnym. Adresy pobierania są czasowe, dlatego przy zachowywaniu wybranego wyniku przechowuj sam plik.

Oceń ciągłość obiektu lub postaci, ruch, widoczny tekst, dialog i synchronizację dźwięku w rozmiarze, w którym klip będzie używany. W kolejnym opisie twórczym wykorzystaj konkretną informację zwrotną: zmieniony gest, pominiętą kwestię lub kadr wymagający korekty. Użytecznym rezultatem jest krótkie ujęcie audiowizualne powiązane z dostarczoną treścią i jasno określonymi zależnościami między referencjami.

", "aboutText": "Szybki wariant H3 po dodatkowym treningu\n\nMiniMax H3 Max to wariant bazowego modelu MiniMax H3 po dodatkowym treningu, zoptymalizowany pod kątem szybszego generowania, zgodności z promptem i jakości audiowizualnej. Wariant opracowano przez dodatkowy trening w fal Research. Zachowuje wspólny kontekst multimodalny oraz natywnie zsynchronizowany obraz i dźwięk. Szybkość jest priorytetem projektowym, a nie stałym czasem wykonania dla każdego promptu, czasu trwania czy zastosowania.\n\nOdróżniaj Max od pierwotnego systemu H3 i osobnego wariantu Max Turbo. Obecny interfejs MiniMax podaje dla Max rozdzielczość 480P lub 768P, domyślnie 768P, 24 klatki na sekundę oraz całkowitą liczbę sekund od 5 do 15. Udokumentowany proces Max nie oferuje ustawienia 2K pierwotnego systemu H3 ani czterosekundowego wyniku.\n\nOd promptu do ujęcia\n\nKażde generowanie zawiera niepusty opis tekstowy, do 7000 znaków na element tekstowy. Opisz temat, kompozycję początkową, akcję i rezultat, a następnie jasno określ pracę kamery i dźwięk. Przy krótkim odsłonięciu przedmiotu wskaż, co widz ma zobaczyć najpierw, jak przedmiot pojawia się w kadrze i jak ujęcie powinno się zakończyć.\n\nPrzydatny pięciosekundowy opis może przedstawiać ceramiczną filiżankę na drewnianym stole, dłoń stawiającą obok spodek, niewielki najazd kamery i odgłos zetknięcia ceramiki z drewnem. Ogranicz akcję tak, aby mieściła się w wybranym czasie, i sprawdź, czy zwrócony ruch i dźwięk dotyczą tego samego zdarzenia.\n\nTworzenie na podstawie klatek\n\nProducent dokumentuje klatkę początkową, końcową lub obie. Pierwszy obraz określa początek klipu, a ostatni — końcowy stan wizualny. Wyjaśnij łączący je ruch, w tym zmiany pozy, położenia przedmiotów, kamery lub oświetlenia. Przy przejściu między dwiema klatkami unikaj opisu wprowadzającego między nimi niepasującą scenę.\n\nWynik oparty na klatkach przyjmuje proporcje obrazu wejściowego. Do pracy wyłącznie z tekstem wybierz konkretne proporcje: 21:9, 16:9, 4:3, 1:1, 3:4 lub 9:16. Praca z referencjami może korzystać z proporcji adaptacyjnych lub jednej z udokumentowanych wartości. Skomponuj referencję lub opisaną scenę dla docelowego kadru, zamiast zakładać, że ten sam układ równie dobrze sprawdzi się w pionie i poziomie.\n\nReferencje multimodalne\n\nObecny schemat generowania Max w MiniMax dokumentuje także referencyjne obrazy, filmy i dźwięk. Określ, na co każdy z nich ma wpływać: tożsamość postaci, otoczenie, wzorzec ruchu, tor kamery, barwę głosu lub cechę dźwięku. W tym interfejsie role pierwszej i ostatniej klatki wykluczają się z rolami mediów referencyjnych.\n\nW ujęciu postaci osobno wskaż referencję wyglądu i referencję ruchu, a następnie podaj docelową akcję oraz wypowiadaną kwestię. Referencja głosu określająca sposób wypowiedzi różni się od kopiowania całego jej sygnału audio. Jasno opisz cechy do zachowania i zmiany do wprowadzenia oraz porównaj rzeczywisty klip audiowizualny z każdą rolą referencji.\n\nRozwijanie promptu\n\nUstawienie rozwijania właściwe dla Max oferuje opcje disabled, balanced i quality, z domyślną wartością balanced. Wybierz disabled, gdy dostarczony opis ma zostać przekazany bez rozwijania; użyj udokumentowanego trybu rozwijania, gdy pożądana jest dodatkowa interpretacja. Zachowaj oryginalny opis, aby odróżnić zmianę wprowadzoną podczas rozwijania od treści, o którą proszono.\n\nOpisuj dźwięk jako część sceny. Wskaż dźwięki fizyczne, odgłosy otoczenia i wszystkie wypowiadane słowa oraz oddziel je od muzyki w tle słyszalnej tylko dla widzów. Podaj dokładną kwestię i zamierzonego mówcę, zamiast prosić o nieokreślony dialog. Nie tylko obejrzyj wynik, lecz także go odsłuchaj; przekonujący obraz nie potwierdza poprawnego brzmienia słów ani ich czasu.\n\nPrzygotowanie danych wejściowych i limity\n\nObecny schemat producenta przyjmuje obrazy JPG, JPEG, PNG, WebP, HEIC lub HEIF, do 30 MB każdy, z bokami od 256 do 5760 pikseli i proporcjami od 0.4 do 2.5. Role początku i końca dopuszczają po jednym obrazie, a tryb referencyjny — maksymalnie dziewięć obrazów. Zachowaj czytelny widok tematu i szczegółów, które muszą pozostać rozpoznawalne.\n\nReferencje wideo dopuszczają maksymalnie trzy klipy MP4 lub MOV, każdy o długości 2–15 sekund, łącznie najwyżej 15 sekund, z limitem 50 MB na plik. Dokumentacja podaje wideo H.264 lub H.265, dźwięk AAC lub MP3, boki od 256 do 5760 pikseli, proporcje od 0.4 do 2.5 i liczbę klatek od 23.976 do 60 na sekundę. Referencje dźwiękowe dopuszczają maksymalnie trzy klipy WAV lub MP3, każdy do 15 MB i o długości 2–15 sekund, łącznie najwyżej 15 sekund. Treść żądania ma osobny limit 64 MB.\n\nUżywaj tylko referencji, które wnoszą coś do ujęcia, i opisz wkład każdej z nich w tekście. Krótki, trafny klip ruchu łatwiej wykorzystać jako wskazówkę niż długi zbiór niepowiązanych zdarzeń. Jasno określ zamierzony czas trwania i rozdzielczość wyjściową, aby można było porównać wynik z tym samym opisem.\n\nGotowy rezultat\n\nAsynchroniczny proces producenta zwraca identyfikator zadania, zanim gotowy film stanie się dostępny. Interfejs odpytywania zadań pobiera zadania z poprzednich siedmiu dni. Zapisz rzeczywisty zwrócony klip i jego specyfikację do montażu lub dalszej oceny; identyfikator zadania nie jest materiałem audiowizualnym. Adresy pobierania są czasowe, dlatego przy zachowywaniu wybranego wyniku przechowuj sam plik.\n\nOceń ciągłość obiektu lub postaci, ruch, widoczny tekst, dialog i synchronizację dźwięku w rozmiarze, w którym klip będzie używany. W kolejnym opisie twórczym wykorzystaj konkretną informację zwrotną: zmieniony gest, pominiętą kwestię lub kadr wymagający korekty. Użytecznym rezultatem jest krótkie ujęcie audiowizualne powiązane z dostarczoną treścią i jasno określonymi zależnościami między referencjami.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "df869923168778c49a2737a3bf219abf7ac611929697f9467d73a12e1127fb29", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Start

MiniMax H3 Max to szybki wariant H3 po dodatkowym treningu, przeznaczony do krótkich filmów ze zsynchronizowanym dźwiękiem. Udokumentowany proces MiniMax obsługuje tekst, obrazy klatek i referencje multimodalne, oferując wynik w 480P lub 768P, czas trwania 5–15 sekund i własne opcje rozwijania promptu.

Akceptowane dane wejściowe
Tekst · Obrazy
Wyniki
Wideo
O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

Szybki wariant H3 po dodatkowym treningu

MiniMax H3 Max to wariant bazowego modelu MiniMax H3 po dodatkowym treningu, zoptymalizowany pod kątem szybszego generowania, zgodności z promptem i jakości audiowizualnej. Wariant opracowano przez dodatkowy trening w fal Research. Zachowuje wspólny kontekst multimodalny oraz natywnie zsynchronizowany obraz i dźwięk. Szybkość jest priorytetem projektowym, a nie stałym czasem wykonania dla każdego promptu, czasu trwania czy zastosowania.

Odróżniaj Max od pierwotnego systemu H3 i osobnego wariantu Max Turbo. Obecny interfejs MiniMax podaje dla Max rozdzielczość 480P lub 768P, domyślnie 768P, 24 klatki na sekundę oraz całkowitą liczbę sekund od 5 do 15. Udokumentowany proces Max nie oferuje ustawienia 2K pierwotnego systemu H3 ani czterosekundowego wyniku.

Od promptu do ujęcia

Każde generowanie zawiera niepusty opis tekstowy, do 7000 znaków na element tekstowy. Opisz temat, kompozycję początkową, akcję i rezultat, a następnie jasno określ pracę kamery i dźwięk. Przy krótkim odsłonięciu przedmiotu wskaż, co widz ma zobaczyć najpierw, jak przedmiot pojawia się w kadrze i jak ujęcie powinno się zakończyć.

Przydatny pięciosekundowy opis może przedstawiać ceramiczną filiżankę na drewnianym stole, dłoń stawiającą obok spodek, niewielki najazd kamery i odgłos zetknięcia ceramiki z drewnem. Ogranicz akcję tak, aby mieściła się w wybranym czasie, i sprawdź, czy zwrócony ruch i dźwięk dotyczą tego samego zdarzenia.

Tworzenie na podstawie klatek

Producent dokumentuje klatkę początkową, końcową lub obie. Pierwszy obraz określa początek klipu, a ostatni — końcowy stan wizualny. Wyjaśnij łączący je ruch, w tym zmiany pozy, położenia przedmiotów, kamery lub oświetlenia. Przy przejściu między dwiema klatkami unikaj opisu wprowadzającego między nimi niepasującą scenę.

Wynik oparty na klatkach przyjmuje proporcje obrazu wejściowego. Do pracy wyłącznie z tekstem wybierz konkretne proporcje: 21:9, 16:9, 4:3, 1:1, 3:4 lub 9:16. Praca z referencjami może korzystać z proporcji adaptacyjnych lub jednej z udokumentowanych wartości. Skomponuj referencję lub opisaną scenę dla docelowego kadru, zamiast zakładać, że ten sam układ równie dobrze sprawdzi się w pionie i poziomie.

Referencje multimodalne

Obecny schemat generowania Max w MiniMax dokumentuje także referencyjne obrazy, filmy i dźwięk. Określ, na co każdy z nich ma wpływać: tożsamość postaci, otoczenie, wzorzec ruchu, tor kamery, barwę głosu lub cechę dźwięku. W tym interfejsie role pierwszej i ostatniej klatki wykluczają się z rolami mediów referencyjnych.

W ujęciu postaci osobno wskaż referencję wyglądu i referencję ruchu, a następnie podaj docelową akcję oraz wypowiadaną kwestię. Referencja głosu określająca sposób wypowiedzi różni się od kopiowania całego jej sygnału audio. Jasno opisz cechy do zachowania i zmiany do wprowadzenia oraz porównaj rzeczywisty klip audiowizualny z każdą rolą referencji.

Rozwijanie promptu

Ustawienie rozwijania właściwe dla Max oferuje opcje disabled, balanced i quality, z domyślną wartością balanced. Wybierz disabled, gdy dostarczony opis ma zostać przekazany bez rozwijania; użyj udokumentowanego trybu rozwijania, gdy pożądana jest dodatkowa interpretacja. Zachowaj oryginalny opis, aby odróżnić zmianę wprowadzoną podczas rozwijania od treści, o którą proszono.

Opisuj dźwięk jako część sceny. Wskaż dźwięki fizyczne, odgłosy otoczenia i wszystkie wypowiadane słowa oraz oddziel je od muzyki w tle słyszalnej tylko dla widzów. Podaj dokładną kwestię i zamierzonego mówcę, zamiast prosić o nieokreślony dialog. Nie tylko obejrzyj wynik, lecz także go odsłuchaj; przekonujący obraz nie potwierdza poprawnego brzmienia słów ani ich czasu.

Przygotowanie danych wejściowych i limity

Obecny schemat producenta przyjmuje obrazy JPG, JPEG, PNG, WebP, HEIC lub HEIF, do 30 MB każdy, z bokami od 256 do 5760 pikseli i proporcjami od 0.4 do 2.5. Role początku i końca dopuszczają po jednym obrazie, a tryb referencyjny — maksymalnie dziewięć obrazów. Zachowaj czytelny widok tematu i szczegółów, które muszą pozostać rozpoznawalne.

Referencje wideo dopuszczają maksymalnie trzy klipy MP4 lub MOV, każdy o długości 2–15 sekund, łącznie najwyżej 15 sekund, z limitem 50 MB na plik. Dokumentacja podaje wideo H.264 lub H.265, dźwięk AAC lub MP3, boki od 256 do 5760 pikseli, proporcje od 0.4 do 2.5 i liczbę klatek od 23.976 do 60 na sekundę. Referencje dźwiękowe dopuszczają maksymalnie trzy klipy WAV lub MP3, każdy do 15 MB i o długości 2–15 sekund, łącznie najwyżej 15 sekund. Treść żądania ma osobny limit 64 MB.

Używaj tylko referencji, które wnoszą coś do ujęcia, i opisz wkład każdej z nich w tekście. Krótki, trafny klip ruchu łatwiej wykorzystać jako wskazówkę niż długi zbiór niepowiązanych zdarzeń. Jasno określ zamierzony czas trwania i rozdzielczość wyjściową, aby można było porównać wynik z tym samym opisem.

Gotowy rezultat

Asynchroniczny proces producenta zwraca identyfikator zadania, zanim gotowy film stanie się dostępny. Interfejs odpytywania zadań pobiera zadania z poprzednich siedmiu dni. Zapisz rzeczywisty zwrócony klip i jego specyfikację do montażu lub dalszej oceny; identyfikator zadania nie jest materiałem audiowizualnym. Adresy pobierania są czasowe, dlatego przy zachowywaniu wybranego wyniku przechowuj sam plik.

Oceń ciągłość obiektu lub postaci, ruch, widoczny tekst, dialog i synchronizację dźwięku w rozmiarze, w którym klip będzie używany. W kolejnym opisie twórczym wykorzystaj konkretną informację zwrotną: zmieniony gest, pominiętą kwestię lub kadr wymagający korekty. Użytecznym rezultatem jest krótkie ujęcie audiowizualne powiązane z dostarczoną treścią i jasno określonymi zależnościami między referencjami.

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Wideo POST /v1/videos
Wejście
text, image
Wyjście
video
Format wyjściowy
oryginalne bajty MP4; bez normalizacji i transkodowania
PoleTypWymaganieWartości i limityDomyślnie
PolemodelTypstringWymaganieWymaganeWartości i limity
minimax/hailuo-3-max
Domyślnie—
PolepromptTypstringWymaganieWymaganeWartości i limityDomyślnie—
PoledurationTypintegerWymaganieWymaganeWartości i limity
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maksimum: 600
Domyślnie—
PoleresolutionTypstringWymaganieOpcjonalneWartości i limity
768p, 480p
Domyślnie—
Poleaspect_ratioTypstringWymaganieOpcjonalneWartości i limity
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Domyślnie—
Polegenerate_audioTypbooleanWymaganieOpcjonalneWartości i limity
false
Domyślnie—
Poleframe_imagesTyparrayWymaganieOpcjonalneWartości i limity
Minimalna liczba elementów: 1
Maksymalna liczba elementów: 2
Treść wejściowa: Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.
Dokładne klucze: type, image_url, frame_type
Warunki: Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.
Domyślnie—
Poleinput_referencesTyparrayWymaganieOpcjonalneWartości i limityDomyślnie—
Polecallback_urlTypstringWymaganieOpcjonalneWartości i limity
Wzorzec: ^https://
Domyślnie—
Polesession_idTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
PoletraceTypobjectWymaganieOpcjonalneWartości i limityDomyślnie—
PoleuserTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Kombinacje materiałów wejściowych

Tekst na wideo · Prompt tekstowy. · Wymagane: model, prompt, duration

Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

Obraz na wideo · Prompt tekstowy i obraz pierwszej klatki. · Wymagane: model, prompt, duration, frame_images

frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.

Dokładne klucze: type, image_url, frame_type

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

Parametry i cykl życia metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt, duration
Parametrmaterial_typesKontrakttext, image
Parametradditional_propertiesKontraktfalse
Parametroptional_controlsKontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Cykl życia: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki
Nie określono Gdy wybrany jest tryb szybki
Tryb flex
Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania
Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

KonfiguracjaTabela stawekPrzewidywana ilośćSkładnik opłatyJednostka rozliczeniowaWarunki rozliczaniaOpłata
KonfiguracjaBazowe stawki za tokenyTabela stawekStawka podstawowaPrzewidywana ilość—Składnik opłaty—Jednostka rozliczeniowa—Warunki rozliczania—Opłata
Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów
Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów
Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów
Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów
Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
KonfiguracjaWyjściowe wideo · stawka referencyjnaTabela stawek—Przewidywana ilość—Składnik opłatyreference_output_rateJednostka rozliczeniowaza sekundę wynikuWarunki rozliczania—Opłata
Wyjście · Referencyjna stawka za sekundę wideo na wyjściu · Szacunek tylko do porównania $0.16 za sekundę wyniku
KonfiguracjaCena wideoTabela stawek—Przewidywana ilość—Składnik opłaty—Jednostka rozliczeniowaza sekundę wideoWarunki rozliczaniaresolution: 480pOpłata
Wyjście · Cena wideo · Szacunek tylko do porównania $0.1 za sekundę wideo
KonfiguracjaCena wideoTabela stawek—Przewidywana ilość—Składnik opłaty—Jednostka rozliczeniowaza sekundę wideoWarunki rozliczaniaresolution: 768pOpłata
Wyjście · Cena wideo · Szacunek tylko do porównania $0.16 za sekundę wideo
KonfiguracjaSzacowany koszt generowaniaTabela stawek—Przewidywana ilośćszacunek dla jednego generowaniaSkładnik opłaty—Jednostka rozliczeniowa—Warunki rozliczania—Opłata
Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.5 szacunek przed generowaniem

Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Szczegóły taryfy referencyjnej

Referencyjne tabele modelu nie zmieniają wyboru metody, wyceny ani opłat. Naliczane opłaty korzystają ze stawek wybranej metody Ailoot.

Referencje cenowe konfiguracji wideo

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

KonfiguracjaWarunki rozliczaniaOpłata
KonfiguracjaCena wideoWarunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku.Opłata
Wyjście · Cena wideo $0.16 za sekundę wideo

Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.

KonfiguracjaCena wideoWarunki rozliczaniaresolution: 480pOpłata
Wyjście · Cena wideo $0.1 za sekundę wideo

Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.

KonfiguracjaCena wideoWarunki rozliczaniaresolution: 768pOpłata
Wyjście · Cena wideo $0.16 za sekundę wideo

Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.

Przykładowe żądania

Ailoot Ultra · Wideo

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Odbieranie i zapisywanie wyników

Ailoot Ultra · Wideo

podpisane adresy URL treści należących do użytkownika

Sprawdź status zadania
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Inne odczyty treści
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Zachowaj wszystkie ukończone wyniki

Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.

Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.

Jeśli trzeba sprawdzić pierwotną odpowiedź

503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania

Pola odpowiedzi
PoleTypZnaczenie
PoleindexTypintegerZnaczeniePozycja tego wideo na liście wyników, liczona od zera.
Polecontent_urlTypstringZnaczeniePodpisany URL HTTPS do pobrania tego ukończonego wideo.
Polesha256Typstring | nullZnaczenieSkrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.
Polesize_bytesTypinteger | nullZnaczenieRozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.
Poleduration_msTypinteger | nullZnaczenieZmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.
PolewidthTypinteger | nullZnaczenieSzerokość wideo w pikselach; null, jeśli jest niedostępna.
PoleheightTypinteger | nullZnaczenieWysokość wideo w pikselach; null, jeśli jest niedostępna.
Polevideo_codecTypstring | nullZnaczenieIdentyfikator kodeka wideo; null, jeśli go nie zapisano.
Polehas_audioTypboolean | nullZnaczenieCzy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.
Poleaudio_codecTypstring | nullZnaczenieIdentyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.
Błędy i dalsze kroki
OdpowiedźWarunekNastępny krok
Odpowiedź404 · not_found_errorWarunekNie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.Następny krokSprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.
Odpowiedź401 · authentication_errorWarunekKlucz API nie odpowiada uwierzytelnionemu kontu.Następny krokSprawdź swój klucz API i dostęp do konta przed wysłaniem.
Odpowiedź400 · invalid_request_errorWarunekNie można odczytać żądania lub indeks pobierania jest nieprawidłowy.Następny krokPopraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.
Odpowiedź422 · price_unavailableWarunekNie można wycenić wybranej konfiguracji wideo.Następny krokWybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.
Odpowiedź422 · invalid_request_errorWarunekWejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.Następny krokUżywaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.
Odpowiedź402 · billing_errorWarunekDostępne saldo lub limity nie pozwalają na rezerwację.Następny krokSprawdź dostępne saldo i limity przed wysłaniem nowego żądania.
Odpowiedź503 · server_errorWarunekWeryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.Następny krokPoczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.
Odpowiedź503 · result_pending_checkWarunekWynik pierwotnego wideo i opłata wymagają sprawdzenia.Następny krokZachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.
Odpowiedź503 · owned_result_unavailableWarunekPobieranie istniejącego wideo jest chwilowo niedostępne.Następny krokSprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.
Odpowiedź409 · video_not_readyWarunekTreść wideo nie została opublikowana.Następny krokSprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.

Aliasy

Aliasy modelu

Ailoot Ultra minimax/hailuo-3-max

Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

Powiązane ID modeli

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Nie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Sprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.", "type": "not_found_error" }, { "condition": "Klucz API nie odpowiada uwierzytelnionemu kontu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Sprawdź swój klucz API i dostęp do konta przed wysłaniem.", "type": "authentication_error" }, { "condition": "Nie można odczytać żądania lub indeks pobierania jest nieprawidłowy.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Popraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.", "type": "invalid_request_error" }, { "condition": "Nie można wycenić wybranej konfiguracji wideo.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.", "type": "price_unavailable" }, { "condition": "Wejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Używaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.", "type": "invalid_request_error" }, { "condition": "Dostępne saldo lub limity nie pozwalają na rezerwację.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Sprawdź dostępne saldo i limity przed wysłaniem nowego żądania.", "type": "billing_error" }, { "condition": "Weryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Poczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Wynik pierwotnego wideo i opłata wymagają sprawdzenia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Pobieranie istniejącego wideo jest chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Sprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.", "type": "server_error" }, { "condition": "Treść wideo nie została opublikowana.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Sprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tekstowy." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tekstowy i obraz pierwszej klatki." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozycja tego wideo na liście wyników, liczona od zera.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpisany URL HTTPS do pobrania tego ukończonego wideo.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Skrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Rozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Zmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Szerokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Wysokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identyfikator kodeka wideo; null, jeśli go nie zapisano.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Czy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpisane adresy URL treści należących do użytkownika", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.", "content": "Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Wyjściowe wideo · stawka referencyjna", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Cena wideo", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "0620d645912cf672de041462ca01f8d300699cf086a379d5a3d6d0afda65de78", "input_html_sha256": "9c12657030871ef3f4514ad0481b8ca46eb11ac8055d98a7f81e048a9961901f", "private_audit_sha256": "af94093a6857cfedfdf3c2141dbebe89ffa036af1edae41660d805e9bbb67f30", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/pl/minimax-hailuo-3-max/", "description": "MiniMax H3 Max to szybki wariant H3 po dodatkowym treningu, przeznaczony do krótkich filmów ze zsynchronizowanym dźwiękiem. Udokumentowany proces MiniMax obsługuje tekst, obrazy klatek i referencje multimodalne, oferując wynik w 480P lub 768P, czas trwania 5–15 sekund i własne opcje rozwijania promptu.", "locale": "pl", "md_url": "https://ailoot.ai/models/pl/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/pl/minimax-hailuo-3-max/" }, "rawModel": { "about": "Szybki wariant H3 po dodatkowym treningu\n\nMiniMax H3 Max to wariant bazowego modelu MiniMax H3 po dodatkowym treningu, zoptymalizowany pod kątem szybszego generowania, zgodności z promptem i jakości audiowizualnej. Wariant opracowano przez dodatkowy trening w fal Research. Zachowuje wspólny kontekst multimodalny oraz natywnie zsynchronizowany obraz i dźwięk. Szybkość jest priorytetem projektowym, a nie stałym czasem wykonania dla każdego promptu, czasu trwania czy zastosowania.\n\nOdróżniaj Max od pierwotnego systemu H3 i osobnego wariantu Max Turbo. Obecny interfejs MiniMax podaje dla Max rozdzielczość 480P lub 768P, domyślnie 768P, 24 klatki na sekundę oraz całkowitą liczbę sekund od 5 do 15. Udokumentowany proces Max nie oferuje ustawienia 2K pierwotnego systemu H3 ani czterosekundowego wyniku.\n\nOd promptu do ujęcia\n\nKażde generowanie zawiera niepusty opis tekstowy, do 7000 znaków na element tekstowy. Opisz temat, kompozycję początkową, akcję i rezultat, a następnie jasno określ pracę kamery i dźwięk. Przy krótkim odsłonięciu przedmiotu wskaż, co widz ma zobaczyć najpierw, jak przedmiot pojawia się w kadrze i jak ujęcie powinno się zakończyć.\n\nPrzydatny pięciosekundowy opis może przedstawiać ceramiczną filiżankę na drewnianym stole, dłoń stawiającą obok spodek, niewielki najazd kamery i odgłos zetknięcia ceramiki z drewnem. Ogranicz akcję tak, aby mieściła się w wybranym czasie, i sprawdź, czy zwrócony ruch i dźwięk dotyczą tego samego zdarzenia.\n\nTworzenie na podstawie klatek\n\nProducent dokumentuje klatkę początkową, końcową lub obie. Pierwszy obraz określa początek klipu, a ostatni — końcowy stan wizualny. Wyjaśnij łączący je ruch, w tym zmiany pozy, położenia przedmiotów, kamery lub oświetlenia. Przy przejściu między dwiema klatkami unikaj opisu wprowadzającego między nimi niepasującą scenę.\n\nWynik oparty na klatkach przyjmuje proporcje obrazu wejściowego. Do pracy wyłącznie z tekstem wybierz konkretne proporcje: 21:9, 16:9, 4:3, 1:1, 3:4 lub 9:16. Praca z referencjami może korzystać z proporcji adaptacyjnych lub jednej z udokumentowanych wartości. Skomponuj referencję lub opisaną scenę dla docelowego kadru, zamiast zakładać, że ten sam układ równie dobrze sprawdzi się w pionie i poziomie.\n\nReferencje multimodalne\n\nObecny schemat generowania Max w MiniMax dokumentuje także referencyjne obrazy, filmy i dźwięk. Określ, na co każdy z nich ma wpływać: tożsamość postaci, otoczenie, wzorzec ruchu, tor kamery, barwę głosu lub cechę dźwięku. W tym interfejsie role pierwszej i ostatniej klatki wykluczają się z rolami mediów referencyjnych.\n\nW ujęciu postaci osobno wskaż referencję wyglądu i referencję ruchu, a następnie podaj docelową akcję oraz wypowiadaną kwestię. Referencja głosu określająca sposób wypowiedzi różni się od kopiowania całego jej sygnału audio. Jasno opisz cechy do zachowania i zmiany do wprowadzenia oraz porównaj rzeczywisty klip audiowizualny z każdą rolą referencji.\n\nRozwijanie promptu\n\nUstawienie rozwijania właściwe dla Max oferuje opcje disabled, balanced i quality, z domyślną wartością balanced. Wybierz disabled, gdy dostarczony opis ma zostać przekazany bez rozwijania; użyj udokumentowanego trybu rozwijania, gdy pożądana jest dodatkowa interpretacja. Zachowaj oryginalny opis, aby odróżnić zmianę wprowadzoną podczas rozwijania od treści, o którą proszono.\n\nOpisuj dźwięk jako część sceny. Wskaż dźwięki fizyczne, odgłosy otoczenia i wszystkie wypowiadane słowa oraz oddziel je od muzyki w tle słyszalnej tylko dla widzów. Podaj dokładną kwestię i zamierzonego mówcę, zamiast prosić o nieokreślony dialog. Nie tylko obejrzyj wynik, lecz także go odsłuchaj; przekonujący obraz nie potwierdza poprawnego brzmienia słów ani ich czasu.\n\nPrzygotowanie danych wejściowych i limity\n\nObecny schemat producenta przyjmuje obrazy JPG, JPEG, PNG, WebP, HEIC lub HEIF, do 30 MB każdy, z bokami od 256 do 5760 pikseli i proporcjami od 0.4 do 2.5. Role początku i końca dopuszczają po jednym obrazie, a tryb referencyjny — maksymalnie dziewięć obrazów. Zachowaj czytelny widok tematu i szczegółów, które muszą pozostać rozpoznawalne.\n\nReferencje wideo dopuszczają maksymalnie trzy klipy MP4 lub MOV, każdy o długości 2–15 sekund, łącznie najwyżej 15 sekund, z limitem 50 MB na plik. Dokumentacja podaje wideo H.264 lub H.265, dźwięk AAC lub MP3, boki od 256 do 5760 pikseli, proporcje od 0.4 do 2.5 i liczbę klatek od 23.976 do 60 na sekundę. Referencje dźwiękowe dopuszczają maksymalnie trzy klipy WAV lub MP3, każdy do 15 MB i o długości 2–15 sekund, łącznie najwyżej 15 sekund. Treść żądania ma osobny limit 64 MB.\n\nUżywaj tylko referencji, które wnoszą coś do ujęcia, i opisz wkład każdej z nich w tekście. Krótki, trafny klip ruchu łatwiej wykorzystać jako wskazówkę niż długi zbiór niepowiązanych zdarzeń. Jasno określ zamierzony czas trwania i rozdzielczość wyjściową, aby można było porównać wynik z tym samym opisem.\n\nGotowy rezultat\n\nAsynchroniczny proces producenta zwraca identyfikator zadania, zanim gotowy film stanie się dostępny. Interfejs odpytywania zadań pobiera zadania z poprzednich siedmiu dni. Zapisz rzeczywisty zwrócony klip i jego specyfikację do montażu lub dalszej oceny; identyfikator zadania nie jest materiałem audiowizualnym. Adresy pobierania są czasowe, dlatego przy zachowywaniu wybranego wyniku przechowuj sam plik.\n\nOceń ciągłość obiektu lub postaci, ruch, widoczny tekst, dialog i synchronizację dźwięku w rozmiarze, w którym klip będzie używany. W kolejnym opisie twórczym wykorzystaj konkretną informację zwrotną: zmieniony gest, pominiętą kwestię lub kadr wymagający korekty. Użytecznym rezultatem jest krótkie ujęcie audiowizualne powiązane z dostarczoną treścią i jasno określonymi zależnościami między referencjami.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Pełny cennik konfiguracji w szczegółach." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Referencje cenowe konfiguracji wideo", "profiles": [ { "basis": "Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.", "dimensions": { "conditions": "W tym kluczu cenowym nie zadeklarowano dodatkowego warunku." }, "label": "Cena wideo", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Cena wideo", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Cena wideo", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3-max", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Nie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Sprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.", "type": "not_found_error" }, { "condition": "Klucz API nie odpowiada uwierzytelnionemu kontu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Sprawdź swój klucz API i dostęp do konta przed wysłaniem.", "type": "authentication_error" }, { "condition": "Nie można odczytać żądania lub indeks pobierania jest nieprawidłowy.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Popraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.", "type": "invalid_request_error" }, { "condition": "Nie można wycenić wybranej konfiguracji wideo.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.", "type": "price_unavailable" }, { "condition": "Wejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Używaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.", "type": "invalid_request_error" }, { "condition": "Dostępne saldo lub limity nie pozwalają na rezerwację.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Sprawdź dostępne saldo i limity przed wysłaniem nowego żądania.", "type": "billing_error" }, { "condition": "Weryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Poczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Wynik pierwotnego wideo i opłata wymagają sprawdzenia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Pobieranie istniejącego wideo jest chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Sprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.", "type": "server_error" }, { "condition": "Treść wideo nie została opublikowana.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Sprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tekstowy." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tekstowy i obraz pierwszej klatki." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozycja tego wideo na liście wyników, liczona od zera.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpisany URL HTTPS do pobrania tego ukończonego wideo.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Skrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Rozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Zmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Szerokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Wysokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identyfikator kodeka wideo; null, jeśli go nie zapisano.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Czy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpisane adresy URL treści należących do użytkownika", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.", "content": "Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Wyjściowe wideo · stawka referencyjna", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Cena wideo", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max to szybki wariant H3 po dodatkowym treningu, przeznaczony do krótkich filmów ze zsynchronizowanym dźwiękiem. Udokumentowany proces MiniMax obsługuje tekst, obrazy klatek i referencje multimodalne, oferując wynik w 480P lub 768P, czas trwania 5–15 sekund i własne opcje rozwijania promptu." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 Max to szybki wariant H3 po dodatkowym treningu, przeznaczony do krótkich filmów ze zsynchronizowanym dźwiękiem. Udokumentowany proces MiniMax obsługuje tekst, obrazy klatek i referencje multimodalne, oferując wynik w 480P lub 768P, czas trwania 5–15 sekund i własne opcje rozwijania promptu.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "9522be8851641767f99c9d96053d692ce032011e564329bc0ab64688e3111de5", "renderer_sha256": "1217dcf19a93e99ac1d6fd7bf974dc19adc12fea4bd4470c2601f04e48f688cb" }, "sourceRevision": "3153c38e7c622ec0657128b487840ac9ebbd04daf25bd757f32e45c96244cc46" }