Dokumenty UlazAI

Obrázek a video APIs

Video studio API

Ceny Dashboard Obrazové studio

POST /api/v1/video-studio/generate/

Kanonický koncový bod generování videa

Používejte Video Studio pro všechny aktuální modely videa. Tento koncový bod podporuje pracovní postupy text-to-video, image-to-video a specifické pro model, jako např video remix.

Pro dynamické integrace načtěte možnosti modelu z /api/v1/models/video/ před odesláním generačního užitečného zatížení.

Nedávné trasy Video Studia zahrnují seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2va happyhorse_videoedit.

Autentizace: odeslat Authorization: Bearer YOUR_API_KEY na každou žádost.

Anketa s /api/v1/video-studio/status/{job_id}/ a načíst poslední pracovních míst od /api/v1/video-studio/history/.

Vyžádejte si smlouvu

Pole	Typ	Povinné	Poznámky
`model_slug`	řetězec	Ano	Musí odpovídat registrovanému modelu Video Studio
`prompt`	řetězec	Obvykle	Vyžadováno pro většinu modelů. Režim Storyboard může začít pouze s obrázky.
`aspect_ratio`	řetězec	Ne	Musí to být jeden z poměrů stran vybraného modelu
`duration_seconds`	celé číslo	Ne	Musí odpovídat povolené délce pro model. Řízení pohybu používá pro stanovení ceny délku klipu pohybu.
`quality_mode`	řetězec	Ne	Vyžadováno, když model definuje režimy kvality
`input_image_urls`	pole [řetězec]	Specifické pro model	Používá se pro modely z obrázku na video. Některé modely vyžadují alespoň jednu adresu URL.
`input_video_urls`	pole [řetězec]	Specifické pro model	Používá se pro video remix a cesty zdroj-video, jako je např `wan_2_6_v2v`, `kling_3_0_motion_control`, `video_lip_sync`a `happyhorse_videoedit`.
`seedance_mode`	řetězec	Pouze seedance 2	Použijte `text_to_video`, `first_frame`, `first_last_frame`nebo `multimodal`.
`first_frame_url`, `last_frame_url`	řetězec	Pouze seedance 2	Použijte pro režimy prvního snímku a prvního+posledního snímku Seedance 2. Veřejné adresy URL a `asset://` ID jsou akceptovány.
`reference_image_urls`, `reference_video_urls`, `reference_audio_urls`	pole [řetězec]	Specifické pro model	Seedance 2 používá multimodální referenční pole. Zvukově řízené trasy jako např `video_lip_sync` a `omnihuman_1_5` použití `reference_audio_urls` pro cílovou řeč nebo mluvený komentář. Veřejné adresy URL a `asset://` ID jsou přijímána tam, kde je vybraný model podporuje.
`character_orientation`	řetězec	Specifické pro model	Pouze Motion Control. Použijte `video` sledovat orientaci pohybového klipu nebo `image` aby se zachovalo orámování nahraného znaku s trváním od 3 do 15 sekund.
`sound`	booleovský	Ne	Používá se pouze u modelů s podporou zvuku
`return_last_frame`, `web_search`	booleovský	Pouze seedance 2	Volitelné příznaky Seedance 2 pro vrácení posledního snímku a povolení webového vyhledávání na straně modelu.
`prompt_directory_optin`	booleovský	Ne	Adresářová sleva platí pouze pro vybrané modelové rodiny

Pro záběry skutečné osoby v Seedance 2 použijte Průvodce aktivy UlazAI Seedance 2 a předat vrácené asset:// ID. Přímé nezpracované soubory mohou selhat.

Volič modelu

Vyberte model pro kontrolu funkcí a automaticky generujte úryvky požadavků.

Gemini Omni Flash 1.2 model_slug=gemini_omni_flash_1_2

Four modes, one per request: text or reference images (duration required, 3-15s, up to 6 images), first frame only (duration required, 3-15s), first and last frame (duration required, 3-10s), or video edit (one source video up to 15s via input_video_urls, no duration, optional reference images; billed on the measured source length). Aspect ratios 16:9, 9:16 or auto; 360p/720p/1080p/4K. Image quota: images plus 2 per video, max 7 total; each file max 20MB. Voice IDs and character IDs are not supported.

motor: Gemini Omni

Poměry stran: 16:9, 9:16, auto

Doba trvání: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 sekund

Režimy kvality: 360p, 720p, 1080p, 4k

Vstupy: obrázek , video

Kredity: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Živé úryvky žádostí

Níže uvedené úryvky se řídí předvolbou vybraného modelu.

cURL (klíč API)

JavaScript (načtení)

Python (požadavky)

Úryvky z dotazování stavu

Stav ankety od job_id dokud completed nebo failed.

cURL

JavaScript (načtení)

Python (požadavky)

Příklady odpovědí

Úspěch

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Chyba ověření

{
  "success": false,
  "error": "Invalid duration for this model"
}

Nedostatek kreditů

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

Klíčový koncový bod videa API (starší)

Pokud potřebujete videohovory založené na klíči API, použijte /api/v1/generate/video/. Tato cesta podporuje a omezená sada modelů a je zdokumentována v rámci staršího video mapování.

Otevřete starší mapování videa Otevřít pracovní postupy stavu Otevřete matici modelu videa