Ugrás a tartalomra

UlazAI fejlesztői dokumentumok

Videóstúdió API

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

Kanonikus videógenerálási végpont

Használja a Video Studiot az összes jelenlegi videomodellhez. Ez a végpont támogatja szöveg-videó, kép-videó és modellspecifikus munkafolyamatok, mint pl videó remix.

A dinamikus integrációkhoz kérje le a modell képességeit innen /api/v1/models/video/ generációs hasznos terhek küldése előtt.

A legújabb Video Studio útvonalak tartalmazzák seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, és happyhorse_videoedit.
Hitelesítés: küldés Authorization: Bearer YOUR_API_KEY minden kérésre.

Szavazás vele /api/v1/video-studio/status/{job_id}/ és töltse be a legutóbbit munkahelyek től /api/v1/video-studio/history/.

Kérjen szerződést

Mező Írja be Kötelező Megjegyzések
model_slug húr Igen Meg kell egyeznie a Video Studio regisztrált modelljével
prompt húr Általában A legtöbb modellhez szükséges. A Storyboard mód csak képekkel indulhat.
aspect_ratio húr Nem A kiválasztott modell egyik képarányának kell lennie
duration_seconds egész szám Nem Meg kell egyeznie a modell megengedett időtartamával. A Motion Control a mozgó klip hosszát használja az árképzéshez.
quality_mode húr Nem Szükséges, ha a modell minőségi módokat határoz meg
input_image_urls tömb[karakterlánc] Modellspecifikus Kép-videó modellekhez használják. Egyes modellekhez legalább egy URL-cím szükséges.
input_video_urls tömb[karakterlánc] Modellspecifikus Videó remix és forrás-video útvonalak használják, mint pl wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, és happyhorse_videoedit.
seedance_mode húr Csak Seedance 2 Használja text_to_video, first_frame, first_last_frame, vagy multimodal.
first_frame_url, last_frame_url húr Csak Seedance 2 Használja az első képkocka és az első+utolsó képkocka Seedance 2 módokhoz. Nyilvános URL-ek és asset:// Személyi igazolványokat elfogadnak.
reference_image_urls, reference_video_urls, reference_audio_urls tömb[karakterlánc] Modellspecifikus A Seedance 2 multimodális referenciatömböket használ. Hangvezérelt útvonalak, mint pl video_lip_sync és omnihuman_1_5 használja reference_audio_urls a célbeszédhez vagy hangfelvételhez. Nyilvános URL-ek és asset:// Az azonosítókat akkor fogadjuk el, ha a kiválasztott modell támogatja azokat.
character_orientation húr Modellspecifikus Csak mozgásvezérlés. Használja video hogy kövesse a mozgó klip tájolását ill image a feltöltött karakter keretezésének megtartásához, 3 és 15 másodperc közötti időtartammal.
sound logikai érték Nem Csak audio támogatással rendelkező modelleken használható
return_last_frame, web_search logikai érték Csak Seedance 2 Opcionális Seedance 2 jelzők az utolsó képkocka visszaadásához és a modelloldali internetes keresés engedélyezéséhez.
prompt_directory_optin logikai érték Nem A címtári kedvezmény csak a kiválasztott modellcsaládokra vonatkozik
A Seedance 2 valós személyű felvételeihez használja a UlazAI Seedance 2 eszközkalauz és adja át a visszaküldöttet asset:// ID. A közvetlen nyers fájlok sikertelenek lehetnek.

Modellválasztó

Válasszon modellt a képességek ellenőrzéséhez és a kérésrészletek automatikus generálásához.

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

Képarányok: 16:9, 9:16, auto

Időtartamok: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 másodpercig

Minőségi módok: 360p, 720p, 1080p, 4k

Bemenetek: kép , videó

Jóváírások: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Élő kérés-részletek

Az alábbi kivonatok követik a kiválasztott modell-előbeállítást.

cURL (API kulcs)

JavaScript (lekérés)

Python (kérések)

Állapotlekérdezési részletek

Szavazás állapota: job_id amíg completed vagy failed.

cURL

JavaScript (lekérés)

Python (kérések)

Válasz példák

Siker

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

Érvényesítési hiba

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

Elégtelen kredit

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

API kulcsú videó végpont (örökölt)

Ha API kulcs alapú videohívásokra van szüksége, használja /api/v1/generate/video/. Ez az út támogatja a korlátozott modellkészlet, és az örökölt videotérképezés alatt van dokumentálva.

Nyissa meg a régi videotérképezést Állapot munkafolyamatok megnyitása Nyissa meg a videó modell mátrixát