Wprowadzenie
API obrazu na wideo w MiniMax H3 Lite zmienia statyczny obraz w klip z dźwiękiem o długości 4–15 sekund w 480p lub 768p. Prześlij pierwszą klatkę, opcjonalnie klatkę końcową, i sprawdź ruch w 480p, zanim zapłacisz za ostrzejszy render. Lekka wersja sprawdza się przy testowaniu pomysłów i tworzeniu wielu wariantów. Każde żądanie daje dokładnie jeden plik MP4, w którym obraz i dźwięk powstają jednocześnie.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| tylko pomysł | MiniMax H3 Lite – tekst na wideo |
| klatkę do animacji, opcjonalnie z klatką końcową | MiniMax H3 Lite – obraz na wideo |
| osoby, stroje, miejsca, klipy ruchu lub głosy | MiniMax H3 Lite – referencje na wideo |
Najważniejsze funkcje
Klatka wyznacza wygląd
Pierwsza klatka ustala twarze, ubrania, światło i kompozycję, więc MiniMax H3 Lite wykorzystuje prompt na to, co się rusza. Klip przejmuje kształt twojej klatki, a pola proporcji nie ma, więc przed wgraniem przytnij obraz do formatu poziomego lub pionowego.
Opcjonalna klatka końcowa
Wyślij drugie zdjęcie jako last_image_url, a klip zatrzyma się na nim, co zamienia dwa nieruchome kadry w kontrolowane przejście. Zamiast wymyślać zakończenie, model planuje ruch między dwoma obrazami, co pomaga, gdy jedno ujęcie ma płynnie przejść w kolejne.
Dźwięk w zestawie
Ruch przychodzi z pasującym dźwiękiem: fale, kroki, śmiech albo kwestia w cudzysłowie, generowane razem z obrazem bez dodatkowej opłaty. Dodaj linię Audio:, jeśli chcesz określonego stylu muzyki lub akustyki pomieszczenia zamiast tego, co podpowiada scena.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagany, 1–7,000 znaków; dłuższe są odrzucane. Wpisz wypowiedzi w cudzysłowie. od 1 znaków · do 7000 znaków |
image_url | Tak | Wymagana pierwsza klatka. Klip zachowuje jej kształt. |
last_image_url | Nie | Opcjonalna klatka końcowa, na której klip się kończy. Nie zmienia ceny. |
resolution | Nie |
|
duration_seconds | Nie | Pełne sekundy, 4–15, domyślnie 5. Rozliczane za sekundę razem z rozdzielczością. |
Cennik
Rozliczane za sekundę wyjścia w wybranej rozdzielczości. Aktualną cenę znajdziesz na stronie modelu.
| Specyfikacja | Cena |
|---|---|
| $0.025 / sekundę |
| $0.04 / sekundę |
Zastosowania
Zdjęcia produktów i mody, które się poruszają
Zdjęcie katalogowe kurtki, torby albo pary butów może otworzyć krótki klip w MiniMax H3 Lite: model przechodzi, obraca produkt lub podnosi go, a oświetlenie z oryginalnej sesji zostaje bez zmian, co oszczędza ponowną sesję przy prostym ruchu.
Ożywianie portretu
Pojedynczy portret staje się krótkim klipem z naturalnym ruchem i dźwiękiem w MiniMax H3 Lite, bez opisywania wyglądu od zera. Jeden uśmiech, obrót głowy albo krok w stronę kamery potrafi ożywić zdjęcie profilowe lub kartę postaci.
Kontrolowane przejścia
Z klatką początkową i końcową MiniMax H3 Lite wypełnia ruch między dwoma zdjęciami. Sprawdza się to w ujęciach przed i po, przy zmianach stroju albo w momentach fabuły, gdy postać zaczyna w jednej pozie, a kończy w innej.
Wskazówki
Opisz kolejny moment, nie obraz
Klatka już pokazuje, kto i gdzie. Prompt zachowaj na akcję, ruch kamery i dźwięk, które następują, w kolejności zdarzeń. Opisanie obrazu po raz drugi zwykle go zamraża, a wyraźna pierwsza akcja, np. odwraca się w stronę okna, nadaje mu ruch.
Używaj klatek w granicach limitów
Klatki muszą mieć 256–5,760 pikseli na bok i stosunek szerokości do wysokości 0.4–2.5; przytnij skrajne panoramy przed wysłaniem. Ostra, dobrze oświetlona klatka z dobrze widocznym bohaterem utrzymuje twarze stabilniej niż mały lub mocno skompresowany obraz.
Dobieraj pasujące klatki
Klatka końcowa działa najlepiej, gdy pokazuje tych samych ludzi i to samo pomieszczenie co początkowa, z zmianą, którą prompt może wyjaśnić, np. nową pozą, krokiem bliżej albo inną miną. Dwa niezwiązane zdjęcia wymuszają skok w stylu cięcia.
Rozliczane za sekundę wyjścia w wybranej rozdzielczości. Aktualną cenę znajdziesz 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-lite/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.
