Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast animuje obraz pierwszej klatki na podstawie krótkiego promptu ruchu. Wybierz ten profil obraz–wideo do ujęcia produktu, pozy postaci lub nieruchomej klatki scenorysu.
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.
MiniMax Hailuo 2.3 Fast to nazwany profil Fast do generowania wideo z obrazu. Zacznij od skomponowanego obrazu pierwszej klatki i opisz, jak ma poruszać się obiekt, postać lub kamera. Zdjęcie produktu, poza postaci lub kadr storyboardu daje ujęciu konkretny wizualny punkt wyjścia.
Przygotuj obraz i opis ruchu
Dostarcz kwadratowy obraz PNG lub JPEG przez adres URL HTTPS, z każdym bokiem od 300 do 4096 pikseli. Pobrany plik obrazu nie może przekraczać 20 000 000 bajtów. Prompt powinien mieć od 1 do 199 znaków i skupiać się na jednym widocznym działaniu oraz ruchu ważnym dla ujęcia.
Śledź klip do zakończenia
Ten profil jest skonfigurowany do tworzenia jednego klipu MP4 o wymiarach 768 × 768 i nominalnej długości sześciu sekund. Wyślij żądanie raz, zapisz zwrócony identyfikator i śledź to pierwotne żądanie aż do zakończenia. Pobierz zwrócone wideo i zachowaj wraz z wynikiem zgłoszone wymiary oraz zmierzony czas trwania. Jeśli rezultat tworzenia jest niepewny, dalej sprawdzaj pierwotne żądanie, zamiast tworzyć je ponownie.
Ailoot Ultra · Wideo POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastStart
MiniMax Hailuo 2.3 Fast animuje obraz pierwszej klatki na podstawie krótkiego promptu ruchu. Wybierz ten profil obraz–wideo do ujęcia produktu, pozy postaci lub nieruchomej klatki scenorysu.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- Wideo
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
- mp4
- Liczba wyników
- Do 1 wynik
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity MiniMax-Hailuo-2.3-Fast | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 Maksymalna długość: 199 Jednostka: znaki Unicode | Domyślnie— |
Poleduration | Typinteger | WymaganieWymagane | Wartości i limity 6 Jednostka: sekundy | Domyślnie— |
Poleresolution | Typstring | WymaganieWymagane | Wartości i limity 768P | Domyślnie— |
Polefirst_frame_image | Typhttps_url | WymaganieWymagane | Wartości i limity Maksymalna liczba bajtów pliku: 20 000 000 Typy MIME: image/png, image/jpeg Minimalny wymiar: 300 Maksymalny wymiar: 4096 Tylko kwadrat: Tak | Domyślnie— |
Kombinacje materiałów wejściowych
Obraz na wideo · Wymagane: prompt, first_frame_image
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration, resolution, first_frame_image |
Parametrother_options | Kontraktfalse |
Parametrduration | Kontrakt6 |
Parametrresolution | Kontrakt768P |
Parametrprompt_max_characters | Kontrakt199 |
Parametrfirst_frame_image | Kontrakt{"type":"https_url","format":["png","jpeg"],"dimensions":"kwadrat 300..4096 pikseli","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Aliasy metody: /v1/videos/generations, /videos, /videos/generations
Cykl życia: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Utwórz raz i zapisz zwrócony identyfikator.
Odpytuj pierwotny status; zachowaj każdy ukończony zasób i jego czas trwania.
Cennik
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)
Stawki Ailoot
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 | Nominalna długość klipu, sekundy | Rozdzielczość | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Nominalna długość klipu, sekundy— | Rozdzielczość— | Jednostka rozliczeniowa— | Opłata Wejście · Tokeny wejściowe — / 1K tokenów Wyjście · Tokeny wyjściowe — / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
| KonfiguracjaUltra | Tabela stawek— | Nominalna długość klipu, sekundy6 | Rozdzielczość768P | Jednostka rozliczeniowaza klip wyjściowy o nominalnej długości 6s | Opłata Wyjście · nominalny klip wyjściowy o długości 6s $0.4 za klip wyjściowy o nominalnej długości 6s |
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.
MiniMax-Hailuo-2.3-Fast
Ceny według konfiguracji
| Konfiguracja | Warunki rozliczania | Opłata |
|---|---|---|
| KonfiguracjaMiniMax-Hailuo-2.3-Fast · Domyślna konfiguracja | Warunki rozliczaniaKonfiguracja domyślna | Opłata Wejście · Wejście 0,00 USD za wywołanie Wyjście · Wyjście 0,40 USD za wywołanie |
MiniMax-Hailuo-2.3-Fast
Ceny według konfiguracji
| Konfiguracja | Warunki rozliczania | Opłata |
|---|---|---|
| KonfiguracjaMiniMax-Hailuo-2.3-Fast · Domyślna konfiguracja | Warunki rozliczaniaKonfiguracja domyślna | Opłata Wejście · Wejście 0,00 USD za wywołanie Wyjście · Wyjście 0,80 USD za wywołanie |
MiniMax-Hailuo-2.3-Fast
Ceny według konfiguracji
| Konfiguracja | Warunki rozliczania | Opłata |
|---|---|---|
| KonfiguracjaMiniMax-Hailuo-2.3-Fast · Konfiguracja domyślna | Warunki rozliczaniaKonfiguracja domyślna | Opłata Wejście · Wejście 0,00 USD za wywołanie Wyjście · Wyjście 0,80 USD za wywołanie |
Przykładowe żądania
Ailoot Ultra · Wideo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
Odbieranie i zapisywanie wyników
Ailoot Ultra · Wideo
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_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.
Ukończone data[] zawiera wszystkie podpisane adresy URL treści należących do użytkownika. Pobierz każdy zwrócony URL lub użyj endpointu treści z index ustawionym na rzeczywisty indeks wyniku. Nieudane pierwotne zadanie może zwrócić charge_pending_check; sprawdź to pierwotne zadanie zamiast tworzyć je ponownie.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Odczytuj istniejące pierwotne zadanie; nigdy nie ponawiaj wysłania o nieznanym wyniku.
Maksymalna liczba wyników: 1.
Pola odpowiedzi
| Pole | Typ | Znaczenie |
|---|---|---|
Poleid | Typstring | Znaczenie— |
Poleobject | Typstring | Znaczenie— |
Polemodel | Typstring | Znaczenie— |
Polestatus | Typstring | Znaczenie— |
Poledata[] | Typsigned content URL | Znaczenie— |
Polecharge_pending_check | Typboolean | Znaczenie— |
Poleerror.code | Typstring | Znaczenie— |
Poleerror.message | Typstring | Znaczenie— |
Polerequested_nominal_duration_seconds | Typinteger | Znaczenie— |
Polemeasured_duration_seconds | Typnumber | Znaczenie— |
Polewidth | Typinteger | Znaczenie— |
Poleheight | Typinteger | Znaczenie— |
Poleoperation_id | Typstring | ZnaczenieZwracane przy status=unknown; rzeczywisty pierwotny publiczny identyfikator operacji wideo |
Polerequest_id | Typstring | ZnaczenieOpcjonalne przy status=unknown; zwracane tylko wtedy, gdy pierwotne zadanie ma identyfikator żądania |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekOdczyt surowej treści żądania kończy się błędem przed parsowaniem profilu wideo | Następny krokZachowaj zwróconą odpowiedź i popraw nieczytelną treść żądania. |
Odpowiedź422 · price_unavailable | WarunekNie można sparsować dokładnego profilu wideo albo kompletny sparsowany profil nie ma gotowej, dokładnie dopasowanej karty cenowej | Następny krokZachowaj odpowiedź; użyj kompletnego, dokładnie dopuszczonego profilu i jego opublikowanej karty. Ta gałąź wykonuje się przed wysłaniem do dostawcy. |
Odpowiedź409 · video_not_ready | WarunekTreść pierwotnego wyniku nie jest jeszcze dostępna | Następny krokOdpytuj pierwotny zwrócony identyfikator i przestrzegaj Retry-After. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Odpowiedź200 · video_result_unverified | WarunekStan pierwotnego zadania Fast jest nieznany; status=unknown i charge_pending_check=true | Następny krokZachowaj faktycznie zwrócone id/operation_id i opcjonalne request_id; odczytuj wyłącznie pierwotne zadanie. Nigdy nie wysyłaj ponownie. |
Aliasy
Aliasy modelu
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Aliasy ścieżek metod
/v1/videos/generations, /videos, /videos/generations
Powiązane ID modeli
FAQ · Hailuo 2.3 Fast
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Jakich pól używa żądanie?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Jakie limity obowiązują?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199