SweetRouterAPI

Obrázky a videa

Videa

Rozpohybujte první snímek podle promptu, volitelně s koncem na posledním snímku.

Generování videí má plnou kapacitu

Pro tento endpoint teď nepřijímáme nové uživatele. Ozvěte se nám, zapíšeme vás na čekací listinu a dáme vědět, jakmile se uvolní místo.

POST/v1/videos

Tělo požadavku

Videa
PoleTypPopis
first_frame_url
Povinné
string (URL)Obrázek přes http nebo https, kterým video začíná.
prompt
Povinné
stringCo se v klipu děje, včetně zvukových pokynů. Až 4 000 znaků.
last_frame_url
Volitelné
string (URL)Volitelný obrázek, kterým video končí.
duration
Volitelné
integerDélka v sekundách, 1 až 15. Výchozí 5.
resolution
Volitelné
string480p (asi 768×384) nebo 720p (asi 1280×704, výchozí). Rozměry platí pro 16:9.
aspect_ratio
Volitelné
stringLibovolný poměr stran obrázku. První snímek se ořízne na střed. Výchozí 2:3.
audio
Volitelné
booleanVýchozí true. Pro němý klip nastavte false.
webhook_url
Volitelné
string (URL)HTTPS adresa, kterou upozorníme po dokončení úlohy. Viz Webhooky.

Příklad

curl
curl -X POST https://api.sweetrouter.com/v1/videos \
  -H "Authorization: Bearer $SWEETROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_frame_url": "https://example.com/frame.png",
    "prompt": "she turns toward the camera and smiles",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "audio": true
  }'

Volání hned vrátí úlohu se stavem queued. Dotazujte se na GET /v1/jobs/:id nebo použijte webhook a pak stáhněte každé outputs[].url.

Snímková frekvence a fronta

Videa se renderují rychlostí 24 snímků za sekundu. Najednou se generuje jeden obrázek nebo video a obrázky ve frontě mají přednost před videi.

Účtování

Videa se účtují za každou sekundu požadované délky při vytvoření úlohy a při selhání se vracejí. Viz Ceník.

Bezpečné opakování

Pošlete hlavičku Idempotency-Key. Opakovaný požadavek se stejným klíčem vrátí původní úlohu, místo aby vytvořil a naúčtoval novou.

curl
curl -X POST https://api.sweetrouter.com/v1/images \
  -H "Authorization: Bearer $SWEETROUTER_API_KEY" \
  -H "Idempotency-Key: order-8812-hero" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a lighthouse at dusk"}'