Wprowadzenie
MiniMax H3 360 Orbit, obraz na wideo zamienia jedno zdjęcie w 360-stopniowy obrót kamery wokół zamrożonej chwili, który kończy się na klatce, od której się zaczął.
Najważniejsze funkcje
- Jedno zdjęcie na wejściu, pełny 360-stopniowy obrót na wyjściu: twoje zdjęcie służy jako pierwsza i ostatnia klatka, więc klip wraca do punktu wyjścia.
- Adapter 360 Orbit działa z siłą 1 i dokładną instrukcją, na której został wytrenowany, więc nie trzeba pisać promptu.
- Bez adaptera ten sam model bazowy odczytuje start i koniec z tym samym obrazem jako nieruchomy kadr i prawie się nie rusza.
- Wynik zachowuje kształt twojego zdjęcia: kwadratowe zdjęcie daje kwadratowy klip.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Zdjęcie, wokół którego krąży kamera. Jest użyte jako pierwsza i ostatnia klatka, dzięki czemu klip się zapętla. od 1 znaków |
resolution | Nie | 480p (domyślnie), 540p, 768p lub 1080p. Wyższe poziomy kosztują więcej za sekundę; kształt kadru zawsze zależy od twojego zdjęcia. |
duration_seconds | Nie | Od 3 do 6 sekund (domyślnie 3). Trzy sekundy to jeden czysty, zamrożony obrót; dłuższe klipy krążą wolniej, a ludzie mogą zacząć się ruszać. |
seed | Nie | Pozwala porównywać przebiegi, gdy testujesz różne zdjęcia lub długości. Nie obiecuje klipu identycznego co do klatki. |
Cennik
Rozliczane za sekundę wyniku w wybranej rozdzielczości.
| Specyfikacja | Cena |
|---|---|
| $0.05 / sekundę |
| $0.075 / sekundę |
| $0.10 / sekundę |
| $0.20 / sekundę |
Zastosowania
- Portrety zamrożonej chwili: osoba, włosy i unoszące się szczegóły pozostają nieruchome, gdy kamera krąży.
- Stylizacje i ubrania pokazane ze wszystkich stron na podstawie jednego ujęcia.
- Krótkie zapętlone klipy do postów w mediach społecznościowych, które kończą się dokładnie tam, gdzie się zaczęły.
Wskazówki
- 3 sekundy dają najczystsze zamrożenie: w naszych testach postać, włosy i zawieszone płatki trzymały się nieruchomo przez cały obrót.
- Przy 6 sekundach orbita jest wolniejsza i osoby mogą zacząć się ruszać, jak tańcząca para w naszych testach.
- Zatłoczony pierwszy plan może przejść przez obiektyw: w tłocznym sadzie pnie na chwilę przechodziły między kamerą a postacią.
- Wybierz kształt zdjęcia, jaki ma mieć klip.
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-360-orbit/image-to-video",
"input": {
"duration_seconds": 3,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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.
