MiniMax: H3
MiniMax H3 generuje krótkie filmy z natywnym dźwiękiem stereo na podstawie tekstu, obrazów klatek lub referencji multimodalnych. Obsługuje tworzenie z pierwszej i ostatniej klatki, edycję z referencjami oraz zależności dotyczące ruchu lub głosu, oferując wynik o długości 4–15 sekund i odrębny proces ponownego generowania w 2K.
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.
Jeden rezultat audiowizualny z opisu multimodalnego
MiniMax H3 to wszechmodalny system wideo MiniMax. Łącznie interpretuje tekst, obrazy, wideo i dźwięk, a następnie generuje film z natywnym dźwiękiem stereo. Producent przedstawia go jako narzędzie do krótkich form twórczych, takich jak wizualizacje produktów, reklamy, animowane plakaty i koncepcje czołówek filmowych, w których związki między materiałami referencyjnymi mają równie duże znaczenie jak opis sceny.
Udokumentowany system tworzy filmy o długości 4–15 sekund przy 24 klatkach na sekundę, z dźwiękiem stereo 32 kHz. Generowanie H3-Base działa w 768p; pełny proces 2K ponownie generuje ten wynik z wykorzystaniem pierwotnego kontekstu multimodalnego. To więcej niż zwykła zmiana rozmiaru: drugi etap ponownie używa modelu i kontekstu źródłowego do odtworzenia drobnych szczegółów. H3 Max i H3-Context-IR mają odrębne role i limity.
Tworzenie z tekstu i na podstawie klatek
Dane wejściowe zawierające wyłącznie tekst opisują całą oś czasu audiowizualnej sceny. Pierwszy obraz zakotwicza początek, ostatni — zakończenie, a dwa obrazy mogą określić oba te punkty. W ujęciu z pierwszej klatki zacznij od kompozycji i tożsamości widocznych na obrazie, a następnie opisz rozwijającą się z nich akcję. Przy przejściu od pierwszej do ostatniej klatki opisz obserwowalny ruch łączący dwa stany, zamiast powtarzać dwa niepowiązane opisy obrazów.
Praktyczny opis produktu może określać zamknięte opakowanie w pierwszej klatce, otwierającą je dłoń, delikatny ruch kamery i stan końcowy, który trzeba osiągnąć. Zachowaj w dostarczonych klatkach kształt przedmiotu, położenie etykiety i oświetlenie. Tworzenie na podstawie klatek i tworzenie z referencjami są odrębnymi trybami wejściowymi; interfejs producenta nie łączy ról pierwszej i ostatniej klatki z rolami mediów referencyjnych w jednym żądaniu.
Generowanie i edycja z referencjami
Tryb referencyjny przyjmuje tekst wraz z obrazami, klipami wideo i klipami audio. Określ wkład każdego źródła: wygląd postaci, lokalizację, ruch kamery, strukturę czasową klipu źródłowego lub głos. Film używany wyłącznie jako wzorzec ruchu kamery różni się od filmu, który ma być faktycznie edytowany lub kontynuowany. Jasno określ tę zależność.
Przewodnik referencyjny producenta rozdziela definicje obiektów i postaci, podsumowanie zadania, analizę elementów do zachowania, szczegółowy opis ujęcia, ogólną warstwę dźwiękową i muzykę w tle słyszalną tylko dla widzów. Odróżnia zachowanie widocznej treści od przenoszenia cech lub ogólnej referencji stylu. W przypadku audio kopiowanie sygnału różni się od odwołania do barwy, rytmu czy sposobu wypowiedzi. Utrzymuj te role spójnie w całym opisie.
Do sceny opartej na referencjach dostarcz obraz postaci, krótką referencję ruchu kamery i dźwiękową referencję głosu, a następnie opisz, gdzie każda z nich ma wpływać na docelowe ujęcie. Określ, które szczegóły ubrania, otoczenia lub przedmiotu muszą pozostać rozpoznawalne. Porównaj gotowy klip z tymi wymaganiami, uwzględniając ciągłość ruchu i związek między widocznym mówcą a słyszanym głosem.
Mowa, dźwięk i czas ujęć
H3 wspólnie modeluje dialog, dźwięki fizyczne, odgłosy otoczenia i muzykę. Karta modelu dokumentuje stabilną obsługę dialogu po arabsku, chińsku, angielsku, francusku, niemiecku, włosku, japońsku, koreańsku, portugalsku, rosyjsku i hiszpańsku; wsparcie dla pozostałych języków określono jako zróżnicowane. Podaj dokładne wypowiadane słowa i język, zachowując stałą tożsamość mówcy między ujęciami.
Przewodniki producenta dotyczące promptów używają angielskiego w częściach opisowych, zachowując dialog i widoczny tekst w ich oryginalnym języku. Treść mówiona korzysta z zapisu <d>[Language] ...</d>, a tożsamość mówcy i opis głosu znajdują się poza tym blokiem. Odróżnij mowę postaci od narracji spoza kadru i wskaż, kiedy kwestia trwa przez cięcie lub urywa się wraz z końcem. Dokładnie zachowaj również widoczny tekst. Dopasuj ilość mowy do wybranego czasu trwania i sprawdź łącznie wyświetlone słowa oraz słyszaną kwestię.
Opisuj ruch kamery jako działanie, podając zakres i szybkość, gdy mają znaczenie. Numeruj ujęcia w kolejności odtwarzania i utrzymuj czasy cięć w granicach długości filmu. Oddziel dźwięki sceny, takie jak kroki lub zamykanie drzwi, od podkładu muzycznego słyszalnego tylko dla widzów. Dzięki tym wyborom krótki plan ujęć jest łatwiejszy do zinterpretowania i porównania z wynikiem.
Przygotowanie danych wejściowych i limity liczbowe
Obecny schemat generowania wymaga niepustego tekstu w każdym trybie, z limitem 7000 znaków na element tekstowy. Obrazy mogą mieć format JPG, JPEG, PNG, WebP, HEIC lub HEIF, do 30 MB każdy, każdy bok od 256 do 5760 pikseli i proporcje od 0.4 do 2.5. Wejście klatkowe dopuszcza jeden obraz początkowy i jeden końcowy; tryb referencyjny — maksymalnie dziewięć obrazów referencyjnych.
Referencje wideo mogą obejmować maksymalnie trzy klipy MP4 lub MOV, każdy o długości 2–15 sekund, łącznie nie więcej niż 15 sekund. Klip może mieć do 50 MB; jego kodek wideo to H.264 lub H.265, z dźwiękiem AAC lub MP3, bokami od 256 do 5760 pikseli, proporcjami od 0.4 do 2.5 i liczbą klatek od 23.976 do 60 na sekundę. Referencje audio obsługują maksymalnie trzy klipy WAV lub MP3, do 15 MB każdy, każdy o długości 2–15 sekund i łącznie nie więcej niż 15 sekund. Karta modelu ogranicza mieszane referencje wejściowe do 12 plików. Udokumentowany limit treści żądania wynosi 64 MB i jest odrębny od limitów pojedynczych plików.
Wybieraj tylko referencje wnoszące coś do opisu i jasno określ wkład każdej z nich. Czytelny widok obiektu lub postaci jest bardziej przydatny niż kilka sprzecznych widoków bez wyjaśnienia. Zachowaj kolejność referencji, wykadruj nieistotne elementy bez usuwania potrzebnego kontekstu sceny i sprawdź, czy krótkie klipy źródłowe zawierają żądaną akcję lub cechę głosu.
Format wyniku i kompletny system
Interfejs H3 producenta oferuje 768P i 2K. Generowanie wyłącznie z tekstu wymaga konkretnych proporcji: 21:9, 16:9, 4:3, 1:1, 3:4 lub 9:16. Tworzenie z pierwszej i ostatniej klatki przyjmuje proporcje obrazu wejściowego; tworzenie z referencjami może korzystać z proporcji adaptacyjnych lub wskazanych wprost. Całkowita liczba sekund wyniku mieści się w zakresie 4–15.
Karta modelu wyróżnia H3-Context-IR, który interpretuje i wzbogaca opis, H3-Base, który generuje treść audiowizualną, oraz H3-Regenerate-2K, który tworzy wynik o wyższej rozdzielczości. Udostępnione bazowe punkty kontrolne rozdzielają zadania oparte na klatkach i zadania z wieloma rodzajami referencji. Komponenty kontekstu i ponownego generowania są odrębne od tych bazowych wag, dlatego sama nazwa otwartego punktu kontrolnego nie określa zachowania całego systemu.
Proces generowania producenta jest asynchroniczny. Interfejs odpytywania zadań pobiera zadania z poprzednich siedmiu dni. Zachowaj identyfikator zadania do czasu zwrócenia rzeczywistego filmu, a następnie zapisz klip zamiast przechowywać wyłącznie czasowy adres pobierania. Oceń tożsamość wizualną, drobny tekst, interakcje przedmiotów, treść mówioną i synchronizację dźwięku w docelowym rozmiarze wyświetlania. Producent wskazuje rozumienie multimodalne i drobne szczegóły wizualne jako obszary dalszych ulepszeń; szczegółowy opis i porównanie ze źródłami pozostają kluczowe dla użytecznego rezultatu.
Ailoot Ultra · Wideo POST /v1/videos minimax/hailuo-3
minimax/hailuo-3Start
MiniMax H3 generuje krótkie filmy z natywnym dźwiękiem stereo na podstawie tekstu, obrazów klatek lub referencji multimodalnych. Obsługuje tworzenie z pierwszej i ostatniej klatki, edycję z referencjami oraz zależności dotyczące ruchu lub głosu, oferując wynik o długości 4–15 sekund i odrębny proces ponownego generowania w 2K.
- Akceptowane dane wejściowe
- Tekst · Obrazy · Audio · Wideo
- Wyniki
- Wideo
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Wideo POST /v1/videos
- Wejście
text,image,audio,video- Wyjście
video- Format wyjściowy
- oryginalne bajty MP4; bez normalizacji i transkodowania
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity minimax/hailuo-3 | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Poleduration | Typinteger | WymaganieWymagane | Wartości i limity 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Domyślnie— |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 2K | Domyślnie— |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Domyślnie— |
Polegenerate_audio | Typboolean | WymaganieOpcjonalne | Wartości i limity false, true | Domyślnie— |
Poleframe_images | Typarray | WymaganieOpcjonalne | Wartoś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_references | Typarray | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polecallback_url | Typstring | WymaganieOpcjonalne | Wartości i limity Wzorzec: ^https:// | Domyślnie— |
Polesession_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poletrace | Typobject | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleuser | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyś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
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. W jednym żądaniu używaj obrazów klatek albo obrazów referencyjnych; nie łącz obu. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.
Dokładne klucze: type, image_url, frame_type
model: Typ: string · minimax/hailuo-3
prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak
Reference to video · Prompt tekstowy oraz obsługiwane materiały referencyjne w postaci obrazów, wideo i dźwięku. · Wymagane: model, prompt, duration, input_references
input_references to tablica obiektów. Ustaw type na image_url, video_url lub audio_url i użyj odpowiadającego mu pola zawierającego url. Używaj publicznych adresów URL przez HTTPS. Pomiń frame_images, aby wybrać tryb materiałów referencyjnych. Oszacowanie uwzględnia wyświetlaną składową za obraz wyłącznie dla obrazów referencyjnych po pierwszych pięciu. Końcowa opłata odpowiada faktycznie rozliczonej konfiguracji. Nie łącz obrazów referencyjnych z obrazami klatek. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.
model: Typ: string · minimax/hailuo-3
prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image, audio, video |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, 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.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Jednostka rozliczeniowa | Warunki rozliczania | Opłata |
|---|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | 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 |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku. | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.26 za sekundę wideo |
| Konfiguracjaobraz referencyjny | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza obraz referencyjny | Warunki rozliczania— | Opłata Wejście · obraz referencyjny · Szacunek tylko do porównania $0.08 za obraz referencyjny |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Jednostka rozliczeniowa— | Warunki rozliczania— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $1.3 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.
| Konfiguracja | Warunki rozliczania | Opłata |
|---|---|---|
| KonfiguracjaCena wideo | Warunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku. | Opłata Wyjście · Cena wideo $0.26 za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaObrazy referencyjne po pierwszych pięciu | Warunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku. | Opłata Wejście · Obrazy referencyjne po pierwszych pięciu $0.08 za obraz Pierwszych pięć obrazów referencyjnych jest bezpłatnych; podana stawka za obraz obowiązuje po pierwszych pięciu. Opublikowana referencja cenowa dotyczy pokazanej konfiguracji. Końcowe opłaty odpowiadają faktycznie rozliczonej konfiguracji. |
Przykładowe żądania
Ailoot Ultra · Wideo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Odbieranie i zapisywanie wyników
Ailoot Ultra · Wideo
podpisane adresy URL treści należących do użytkownika
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Sprawdź status zadania
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Inne odczyty treści
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
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')
target=Path('owned-'+label+'.bin')
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)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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
| Pole | Typ | Znaczenie |
|---|---|---|
Poleindex | Typinteger | ZnaczeniePozycja tego wideo na liście wyników, liczona od zera. |
Polecontent_url | Typstring | ZnaczeniePodpisany URL HTTPS do pobrania tego ukończonego wideo. |
Polesha256 | Typstring | null | ZnaczenieSkrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny. |
Polesize_bytes | Typinteger | null | ZnaczenieRozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny. |
Poleduration_ms | Typinteger | null | ZnaczenieZmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny. |
Polewidth | Typinteger | null | ZnaczenieSzerokość wideo w pikselach; null, jeśli jest niedostępna. |
Poleheight | Typinteger | null | ZnaczenieWysokość wideo w pikselach; null, jeśli jest niedostępna. |
Polevideo_codec | Typstring | null | ZnaczenieIdentyfikator kodeka wideo; null, jeśli go nie zapisano. |
Polehas_audio | Typboolean | null | ZnaczenieCzy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono. |
Poleaudio_codec | Typstring | null | ZnaczenieIdentyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora. |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź404 · not_found_error | WarunekNie 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_error | WarunekKlucz API nie odpowiada uwierzytelnionemu kontu. | Następny krokSprawdź swój klucz API i dostęp do konta przed wysłaniem. |
Odpowiedź400 · invalid_request_error | WarunekNie 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_unavailable | WarunekNie 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_error | WarunekWejś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_error | WarunekDostępne saldo lub limity nie pozwalają na rezerwację. | Następny krokSprawdź dostępne saldo i limity przed wysłaniem nowego żądania. |
Odpowiedź503 · server_error | WarunekWeryfikacja 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_check | WarunekWynik 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_unavailable | WarunekPobieranie 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_ready | WarunekTreść 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
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · MiniMax: H3
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- Jakich pól używa żądanie?
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Jakie limity obowiązują?
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1