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ů.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

motor: Seedance 2.5

Poměry stran: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Doba trvání: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 sekund

Režimy kvality: 480p, 720p, 1080p

Vstupy: text , obrázek , video

Kredity: 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 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