Generowanie wideo z własnego systemu

To samo API, z którego korzysta studio. Wysyłasz opis po polsku, dostajesz identyfikator zlecenia, po kilku minutach pobierasz MP4. Dostęp do API jest w pakiecie Studio; klucz znajdziesz w panelu w zakładce „API".

Jak to działa

1. Każde żądanie ma nagłówek X-Token z Twoim kluczem.
2. POST /api/generate przyjmuje formularz (multipart), zdejmuje kredyty i zwraca job_id. Generacja idzie w tle - od 3 do 11 minut na każde 30 sekund.
3. GET /api/jobs podaje status. Gdy status to done, plik jest pod /api/jobs/{id}/video.

Kredyty zdejmowane są tak samo jak w studiu: jeden kredyt to pięć sekund w Full HD, 720p liczy 0,7 kredytu, 4K dwa. Nieudana generacja zwraca kredyty automatycznie. Adres bazowy: https://zwid.pl.

1. Wycena przed zleceniem

POST/api/quote - bez klucza, nie pobiera kredytów.

curl -s https://zwid.pl/api/quote \
  -H "Content-Type: application/json" \
  -d '{"duration": 10, "quality": "1080p", "variants": 1}'

{"duration":10,"quality":"1080p","variants":1,"credits":2,"pln":17,"credits_one":2,"segments":1}

2. Zlecenie

POST/api/generate - formularz multipart.

curl -s https://zwid.pl/api/generate \
  -H "X-Token: TWÓJ_KLUCZ" \
  -F "scene=Skórzany portfel obraca się powoli na ciemnym kamiennym podeście, boczne światło podkreśla fakturę" \
  -F "fmt=product" -F "duration=10" -F "aspect_ratio=9:16" -F "quality=1080p" \
  -F "title=Portfel - obrót" \
  -F "reference=@portfel.jpg"

{"job_id":"0acf86d7782f472b","jobs":["0acf86d7782f472b"],"status":"queued","credits":2,"variants":1,"segments":1}

pole	wartość
scene	opis sceny po polsku (albo po angielsku); tłumaczymy i uzupełniamy o detale kadru
fmt	zadanie: rolka, product, reklama, jedzenie, wnetrze, teledysk, cinematic, vlog, asmr, sport, anime, raw (lista: GET /api/formats)
duration	sekundy, od 5; powyżej 30 składamy z odcinków
aspect_ratio	9:16, 1:1 albo 16:9
quality	720p, 1080p albo 4k
variants	1-3 (Pro i Studio: do 5) ujęć tej samej sceny
voice_text	tekst lektora; languages = lista kodów wersji językowych, np. en,de
sub_mode	brak, auto, lektor albo tekst
exports	dodatkowe proporcje z tego samego zlecenia, np. 1:1,16:9
reference	do 30 plików zdjęć; wideo do 10 filmów; audio_ref do 10 ścieżek
prompt_gotowy	true - scene idzie do modelu dosłownie, bez tłumaczenia i szablonu

3. Status i odbiór pliku

GET/api/jobs - Twoje ostatnie zlecenia.

curl -s https://zwid.pl/api/jobs -H "X-Token: TWÓJ_KLUCZ"

{"jobs":[{"id":"0acf86d7782f472b","status":"done","quality":"Full HD 1080p",
  "video_url":"/api/jobs/0acf86d7782f472b/video","scene":"Skórzany portfel…",
  "prompt_en":"Premium product commercial, vertical. …","exports":["1:1"]}]}

curl -s "https://zwid.pl/api/jobs/0acf86d7782f472b/video?token=TWÓJ_KLUCZ" -o portfel.mp4
curl -s "https://zwid.pl/api/jobs/0acf86d7782f472b/export/1:1?token=TWÓJ_KLUCZ" -o portfel-1x1.mp4

Statusy: queued, generating, upscaling, done, failed, rejected. Przy dwóch ostatnich kredyty wracają na konto, a pole error mówi dlaczego.

Limity i zasady

• Pytaj o status nie częściej niż co 5 sekund - webhooki dojdą w kolejnej wersji.
• Dzienny limit zleceń na konto jest taki sam jak w studiu; przy większych wolumenach napisz, podniesiemy go na koncie.
• Pliki trzymamy zgodnie z pakietem (Studio: rok). Pobrane zostają u Ciebie.
• Moderacja jest taka sama jak w studiu: bez osób publicznych i cudzych marek.

Klucz API to ten sam token, którym loguje się studio. Nie wklejaj go do kodu po stronie przeglądarki. „Wyloguj ze wszystkich urządzeń" w ustawieniach unieważnia go i wydaje nowy.