Przewodnik wdrożeniowy
Przejście z obrazu na wideo usuwa najtrudniejszą zmienną – jak wygląda scena – i zastępuje ją węższą: jak ma się poruszać. Klatka referencyjna wykonuje większość pracy, dlatego słabej referencji nie uratuje żaden prompt.
Wyzwanie
Endpointy ruchu dziedziczą po pierwszej klatce wszystko: kompozycję, światło, proporcje, artefakty. Miękka albo źle wykadrowana referencja daje miękki, źle wykadrowany klip – i płacisz za niego stawkę wideo.
01
Jeśli referencja jest 1:1, a prosisz o klip 16:9, endpoint musi dodać pasy, przyciąć albo rozciągnąć obraz. Dopasuj referencję do aspect_ratio albo resolution, o które prosisz, przed wysłaniem, a nie po zapłaceniu za ujęcie.
02
Tam, gdzie zadeklarowano last_image_url, podanie obu końców daje określony początek i koniec zamiast swobodnego dryfu. Tam, gdzie tego pola nie ma, wysłanie go kończy się kodem 400.
03
movement_amplitude, camera_fixed, fps i duration_seconds pojawiają się zależnie od endpointu, a schemat zaznacza, które z nich ruszają stawkę. Pod spodem nie ma wspólnego słownika ruchu.
Podejście
Dopracuj kadr, korzystając z endpointu obrazu, gdzie jedna iteracja kosztuje grosze, zablokuj go i dopiero wtedy płać za ruch. Przekazanie zatwierdzonego pliku spicy:// utrzymuje referencję identyczną co do bajtu między kolejnymi próbami, więc powtórka startuje dokładnie z tych samych pikseli.
Treść to wywołanie tworzące z polem obrazu. Część śledząca jest identyczna jak w każdym innym zadaniu multimedialnym.
POST /api/v1/jobs/createTask
POST /api/v1/jobs/createTask
Authorization: Bearer $SPICY_API_KEY
Idempotency-Key: 7b1f0c2e-9a4d-4f31-8c67-2b5e0d9a1c44
Content-Type: application/json
{
"model": "<publisher>/<model>/image-to-video",
"input": {
"prompt": "Slow push-in, fabric moving in a light breeze",
"image_url": "https://example.com/reference.png",
"duration_seconds": 5,
"resolution": "720p"
},
"callBackUrl": "https://example.com/hooks/spicyapi"
}202 Accepted
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}Kontrakt
| Pole lub nagłówek | Wartość lub limit |
|---|---|
| image_url · last_image_url | declared per endpoint |
| POST /api/v1/jobs/retry | new task · source record untouched |
| state | queued · running · succeeded · failed · expired |
| audio / video upload | ≤ 100 MiB · ≤ 600 s |
Przesuń w poziomie, żeby zobaczyć wszystkie kolumny.
Integracja
Dopasowanie
Dowody
Adresy HTTPS, zatwierdzone pliki spicy:// i osadzone data URI zachowują się tak samo na endpointach obrazu i wideo, przy tych samych limitach i tych samych kontrolach przy przyjęciu.
POST /api/v1/jobs/retry buduje świeże zadanie z nieudanego albo wygasłego i ponownie sprawdza schemat, cenę, uprawnienia i dostępność. Rekord źródłowy zostaje dokładnie taki, jaki był.
queued, running, succeeded, failed, expired. Pięć tych samych słów opisuje każdy endpoint multimedialny, więc logikę przejść piszesz raz.
Przed startem
FAQ
Modele
Każdy odnośnik prowadzi na stronę danej rodziny modeli: wejścia, limity, zasady dotyczące treści i aktualna cena za jednostkę.
Co dalej
Zamień obraz referencyjny w klip. Co robią jakość pierwszej klatki, niezgodne proporcje, pola ruchu i długość – z wynikiem i z ceną.
