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/videosTělo požadavku
| Pole | Typ | Popis |
|---|---|---|
first_frame_urlPovinné | string (URL) | Obrázek přes http nebo https, kterým video začíná. |
promptPovinné | string | Co se v klipu děje, včetně zvukových pokynů. Až 4 000 znaků. |
last_frame_urlVolitelné | string (URL) | Volitelný obrázek, kterým video končí. |
durationVolitelné | integer | Délka v sekundách, 1 až 15. Výchozí 5. |
resolutionVolitelné | string | 480p (asi 768×384) nebo 720p (asi 1280×704, výchozí). Rozměry platí pro 16:9. |
aspect_ratioVolitelné | string | Libovolný poměr stran obrázku. První snímek se ořízne na střed. Výchozí 2:3. |
audioVolitelné | boolean | Výchozí true. Pro němý klip nastavte false. |
webhook_urlVolitelné | 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"}'