Vidu Q3 Pro API

Vidu Q3 Pro to poziom Pro w linii wideo Q3 od Vidu, dostępny jako jeden endpoint obraz→wideo. Wysyłasz klatkę startową w image_url i instrukcję w prompt – oba pola są wymagane – i otrzymujesz od 1 do 16 pełnych sekund wideo w 540p z dźwiękiem wygenerowanym w tym samym przebiegu. Klatka ustala postać, wygląd i kształt wyniku; nie ma pola proporcji obrazu, a proporcje samego obrazu muszą mieścić się między 1:4 a 4:1. Prompt musi więc opisać tylko to, co się porusza.

Jedna rozdzielczość – decydujesz tylko o długości

resolution przyjmuje jedną wartość, 540p, i każdy klip wraca w tym rozmiarze. Zostaje duration_seconds – dowolna liczba całkowita od 1 do 16, domyślnie 5 – czyli ustawienie, które zmienia jednocześnie długość klipu i cenę; szacunek na żywo podąża za nim, gdy je przesuwasz.

Tożsamość pochodzi z kadru

Postać, strój, kadrowanie i kształt wyniku ustala obraz, a nie prompt. Dwa przebiegi z tej samej klatki różnią się ruchem, a nie tym, kto jest na ekranie, dzięki czemu serię klipów z jednego kadru da się zmontować razem. Oznacza to też, że żądanie wideo nie nadpisze niczego, co zatwierdzono na etapie obrazu.

Opisz ruch, potem ustaw jego ilość

movement_amplitude ustala ogólną ilość ruchu – domyślnie auto, poza tym small, medium, large – a prompt mówi, co i jak się rusza. Gdy ujęcie rusza się za bardzo albo za mało, zablokuj seed i klatkę i przepisz tylko ruch – mniejszy obrót, wolniejszy krok – tak by widoczna różnica wynikała z tej jednej zmiany, a nie z nowego losowania.

Serie reakcji jednej postaci

Jedna klatka w kostiumie zamienia się w mrugnięcie, machnięcie ręką, przechylenie głowy i obrót – cztery żądania z tym samym obrazem i czterema różnymi promptami. Ponieważ tożsamość ustala klatka, seria montuje się bez tego, by ktokolwiek zmieniał się między klipami.

Bliska, rytmiczna akcja

Przykład z kuźnią przez sześć sekund trzyma się blisko torsu i przedramion kowala oświetlonych od dołu ogniem, a przy każdym uderzeniu młota tryskają iskry. Powtarzane uderzenia to dobry test dla tego endpointu: iskry muszą pojawiać się w momencie uderzenia, a nie pomiędzy uderzeniami.

Materiały pionowe

Wyeksportuj kadr w 9:16, a klip wróci w pionie. W przykładzie z przejściem podziemnym prompt niesie tylko marsz w stronę obiektywu pod świetlówkami i kamerę cofającą się w jej tempie; pionowy kadr ustalono na etapie obrazu.

Sceny bez cenzury z twojej klatki

Twój kadr jest animowany w takiej postaci, w jakiej go przesłano, bez łagodzenia, a ponieważ treść niesie obraz, wynik pozostaje bliski temu, co zatwierdzono. Vidu Q3 Spicy z tej samej linii to wariant bez cenzury dostrojony przez LoRA.

# 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": "vidu/q3-pro/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "movement_amplitude": "auto",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "540p"
  }
}'

# 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.