Siirry sisältöön
UlazAI

UlazAI kehittäjädokumentit

Videostudio API

Hinnoittelu Kojelauta Kuvastudio
POST /api/v1/video-studio/generate/

Kanoninen videon luomisen päätepiste

Käytä Video Studiota kaikissa nykyisissä videomalleissa. Tämä päätepiste tukee tekstistä videoon, kuvasta videoon ja mallikohtaisia työnkulkuja, kuten video remix.

Dynaamisia integraatioita varten hae mallin ominaisuudet osoitteesta /api/v1/models/video/ ennen sukupolven hyötykuormien lähettämistä.

Viimeaikaiset Video Studion reitit sisältävät seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, ja happyhorse_videoedit.
Todennus: lähetä Authorization: Bearer YOUR_API_KEY jokaisesta pyynnöstä.

Äänestys kanssa /api/v1/video-studio/status/{job_id}/ ja lataa viimeksi työpaikkoja alkaen /api/v1/video-studio/history/.

Pyydä sopimus

Kenttä Tyyppi Pakollinen Huomautuksia
model_slug merkkijono Kyllä On vastattava rekisteröityä Video Studio-mallia
prompt merkkijono Yleensä Pakollinen useimpiin malleihin. Kuvakäsikirjoitustila voi alkaa vain kuvilla.
aspect_ratio merkkijono Ei Sen on oltava jokin valitun mallin kuvasuhteista
duration_seconds kokonaisluku Ei On vastattava mallin sallittua kestoa. Motion Control käyttää liikeleikkeen pituutta hinnoitteluun.
quality_mode merkkijono Ei Vaaditaan, kun malli määrittää laatutilat
input_image_urls array[merkkijono] Mallikohtainen Käytetään kuvasta videoon -malleissa. Jotkut mallit vaativat vähintään yhden URL-osoitteen.
input_video_urls array[merkkijono] Mallikohtainen Käytetään videoremix- ja lähde-videoreiteillä, kuten wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, ja happyhorse_videoedit.
seedance_mode merkkijono Vain Seedance 2 Käytä text_to_video, first_frame, first_last_frame, tai multimodal.
first_frame_url, last_frame_url merkkijono Vain Seedance 2 Käytä ensimmäisen kuvan ja ensimmäisen + viimeisen kuvan Seedance 2 -tiloissa. Julkiset URL-osoitteet ja asset:// Henkilötodistukset hyväksytään.
reference_image_urls, reference_video_urls, reference_audio_urls array[merkkijono] Mallikohtainen Seedance 2 käyttää multimodaalisia viitetaulukoita. Ääniohjatut reitit, kuten video_lip_sync ja omnihuman_1_5 käyttää reference_audio_urls kohdepuhetta tai selostusta varten. Julkiset URL-osoitteet ja asset:// Tunnukset hyväksytään, jos valittu malli tukee niitä.
character_orientation merkkijono Mallikohtainen Vain Motion Control. Käytä video seurataksesi liikeleikkeen suuntaa tai image säilyttää ladatun hahmon kehystyksen kestoltaan 3–15 sekuntia.
sound boolean Ei Käytetään vain malleissa, joissa on äänituki
return_last_frame, web_search boolean Vain Seedance 2 Valinnaiset Seedance 2 -liput viimeisen kehyksen palauttamiseksi ja mallipuolen verkkohaun mahdollistamiseksi.
prompt_directory_optin boolean Ei Hakemistoalennus koskee vain valittuja malliperheitä
Käytä Seedance 2:n tosihenkilökuvaa UlazAI Seedance 2 omaisuusopas ja välitä palautettu asset:// ID. Suorat raakatiedostot saattavat epäonnistua.

Mallin valitsin

Valitse malli, jonka avulla voit tarkistaa ominaisuudet ja luoda pyyntökatkelmia automaattisesti.

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.

Moottori: Gemini Omni

Kuvasuhteet: 16:9, 9:16, auto

Kesto: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 sekuntia

Laatutilat: 360p, 720p, 1080p, 4k

Tulot: kuva , video

Tekijät: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Live-pyynnön katkelmia

Alla olevat katkelmat noudattavat valitun mallin esiasetusta.

cURL (API-avain)

JavaScript (haku)

Python (pyynnöt)

Tilakyselyn katkelmia

Äänestyksen tila job_id asti completed tai failed.

cURL

JavaScript (haku)

Python (pyynnöt)

Vastausesimerkkejä

Menestystä

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

Vahvistusvirhe

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

Riittämättömät luottotiedot

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

API-avainvideon päätepiste (vanha)

Jos tarvitset API-näppäinpohjaisia videopuheluita, käytä /api/v1/generate/video/. Tämä polku tukee a rajoitettu mallisarja, ja se on dokumentoitu vanhan videokartoituksen alla.

Avaa vanha videokartoitus Avaa tilatyönkulut Avaa videomallimatriisi