Wprowadzenie
Obraz na wideo w MiniMax H3 HighSpeed bierze gotowy nieruchomy obraz i animuje go do pliku MP4 o długości 4–15 sekund w 768p, z dźwiękiem. Wygląd ustala obraz, a w prompcie wystarczy napisać, co się rusza.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| tylko pomysł | MiniMax H3 HighSpeed – tekst na wideo |
| klatkę do animacji, opcjonalnie z klatką końcową | MiniMax H3 HighSpeed – obraz na wideo |
| osoby, stroje, miejsca, klipy ruchu lub głosy | MiniMax H3 HighSpeed – referencje na wideo |
Najważniejsze funkcje
Klatka wyznacza wygląd
Twarze, ubrania, światło i kompozycja pochodzą z Twojej pierwszej klatki. Klip zachowuje jej kształt, a pola proporcji nie ma, więc przed wysłaniem przytnij obraz do wybranego formatu, poziomego lub pionowego.
Opcjonalna klatka końcowa
Dodaj last_image_url, a klip zatrzyma się na tym drugim obrazie, dzięki czemu kontrolujesz ruch między dwoma nieruchomymi obrazami. Pomaga to, gdy jedno ujęcie musi czysto przejść w następne.
Dźwięk w zestawie
Ruch przychodzi z pasującym dźwiękiem, takim jak szum fal, kroki, śmiech lub kwestia w cudzysłowie, bez dopłaty. Wiersz Audio: w prompcie wskazuje styl muzyki lub dźwięk pomieszczenia.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagane. Przyjmuje od 1 do 7 000 znaków i odrzuca dłuższy tekst. od 1 znaków · do 7000 znaków |
image_url | Tak | Wymagana pierwsza klatka, której kształt przejmuje klip. Każdy bok musi mieć 256–5 760 pikseli, a stosunek szerokości do wysokości mieścić się między 0,4 a 2,5. |
last_image_url | Nie | Opcjonalna klatka końcowa, na której klip się zatrzymuje. Nie dodaje nic do ceny. |
resolution | Nie |
|
duration_seconds | Nie | Liczba całkowita od 4 do 15 (domyślnie 5); każda sekunda jest rozliczana według stawki 768p. Żądanie na 4 sekundy wróciło jako klip 3,75-sekundowy. |
Cennik
Płacisz za każdą sekundę gotowego klipu w 768p; aktualna stawka jest na stronie modelu.
| Specyfikacja | Cena |
|---|---|
| $0.072 / sekundę |
Zastosowania
Zdjęcia produktów i mody, które się poruszają
Katalogowe zdjęcie kurtki, torby lub butów może otworzyć krótki klip, w którym przedmiot jest zakładany, obracany lub podnoszony, w oświetleniu oryginalnej sesji.
Ożywianie portretu
Pojedynczy portret staje się krótkim klipem z uśmiechem, obrotem głowy lub krokiem w stronę kamery, co wystarcza, by ożywić zdjęcie profilowe lub kartę postaci.
Kontrolowane przejścia
Mając klatkę początkową i końcową, model uzupełnia ruch między nimi: ujęcia przed i po, zmiany stroju albo postać, która zaczyna w jednej pozie, a kończy w innej.
Wskazówki
Opisz kolejny moment, nie obraz
Użyj promptu, by dodać do klatki krótką sekwencję: produkt obracający się ku etykiecie, portret unoszący wzrok, kamera zbliżająca się powoli. Najpierw akcja, potem kamera, na końcu dźwięk.
Używaj klatek w granicach limitów
Utrzymaj każdy bok w zakresie 256–5 760 pikseli, a stosunek szerokości do wysokości między 0,4 a 2,5. Wynik w 768p zachowuje kształt Twojej klatki, więc przed publikacją sprawdź w nim twarze, etykiety i krawędzie.
Dobieraj pasujące klatki
Nadaj klatce początkowej i końcowej to samo kadrowanie i te same proporcje oraz zaplanuj jedno przejście mieszczące się w 4–15 sekundach. Obejrzyj ostatnią sekundę, by sprawdzić, czy ujęcie ląduje na klatce końcowej.
Płacisz za każdą sekundę gotowego klipu w 768p; aktualna stawka jest na stronie modelu.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-highspeed/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
