UlazAI dokumenter

Bilde og video APIs

Videostudio API

Prissetting Dashbord Bildestudio

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

Endepunkt for kanonisk videogenerering

Bruk Video Studio for alle aktuelle videomodeller. Dette endepunktet støtter tekst-til-video, bilde-til-video og modellspesifikke arbeidsflyter som f.eks video remiks.

For dynamiske integrasjoner, hent modellfunksjoner fra /api/v1/models/video/ før du sender generasjonsnyttelast.

Nylige Video Studio-ruter inkluderer seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, og happyhorse_videoedit.

Autentisering: send Authorization: Bearer YOUR_API_KEY på hver forespørsel.

Avstemning med /api/v1/video-studio/status/{job_id}/ og last inn siste jobber fra /api/v1/video-studio/history/.

Be om kontrakt

Felt	Type	Obligatorisk	Notater
`model_slug`	streng	Ja	Må matche en registrert Video Studio-modellsnegl
`prompt`	streng	Vanligvis	Påkrevd for de fleste modeller. Storyboard-modus kan bare starte med bilder.
`aspect_ratio`	streng	Nei	Må være et av den valgte modellens sideforhold
`duration_seconds`	heltall	Nei	Må samsvare med en tillatt varighet for modellen. Motion Control bruker bevegelsesklipslengden for prissetting.
`quality_mode`	streng	Nei	Obligatorisk når modellen definerer kvalitetsmoduser
`input_image_urls`	array [streng]	Modellspesifikk	Brukes for bilde-til-video-modeller. Noen modeller krever minst én URL.
`input_video_urls`	array [streng]	Modellspesifikk	Brukes av videoremikser og kilde-video-ruter som f.eks `wan_2_6_v2v`, `kling_3_0_motion_control`, `video_lip_sync`, og `happyhorse_videoedit`.
`seedance_mode`	streng	Kun Seedance 2	Bruk `text_to_video`, `first_frame`, `first_last_frame`, eller `multimodal`.
`first_frame_url`, `last_frame_url`	streng	Kun Seedance 2	Bruk for første bilde og første+siste bilde Seedance 2-modus. Offentlige nettadresser og `asset://` IDer godtas.
`reference_image_urls`, `reference_video_urls`, `reference_audio_urls`	array [streng]	Modellspesifikk	Seedance 2 bruker multimodale referansematriser. Lyddrevne ruter som f.eks `video_lip_sync` og `omnihuman_1_5` bruk `reference_audio_urls` for måltalen eller voiceoveren. Offentlige nettadresser og `asset://` IDer godtas der den valgte modellen støtter dem.
`character_orientation`	streng	Modellspesifikk	Kun bevegelseskontroll. Bruk `video` for å følge bevegelsesklippets orientering eller `image` for å beholde den opplastede karakterinnrammingen, med varighet fra 3 til 15 sekunder.
`sound`	boolsk	Nei	Kun brukt på modeller med lydstøtte
`return_last_frame`, `web_search`	boolsk	Kun Seedance 2	Valgfrie Seedance 2-flagg for å returnere den siste rammen og aktivere nettsøk på modellsiden.
`prompt_directory_optin`	boolsk	Nei	Katalograbatt gjelder kun utvalgte modellfamilier

For opptak fra ekte personer i Seedance 2, bruk UlazAI Seedance 2 ressursguide og passere den returnerte asset:// ID. Direkte råfiler kan mislykkes.

Modellvelger

Velg en modell for å inspisere funksjoner og automatisk generere forespørselsbiter.

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

Sideforhold: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Varighet: 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 sekunder

Kvalitetsmoduser: 480p, 720p, 1080p

Innganger: tekst , bilde , video

Kreditt: 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

Direkte forespørselssnutter

Snuttene nedenfor følger den valgte modellforhåndsinnstillingen.

cURL (API nøkkel)

JavaScript (hent)

Python (forespørsler)

Utdrag av statusavstemning

Avstemningsstatus etter job_id inntil completed eller failed.

curL

JavaScript (hent)

Python (forespørsler)

Eksempler på respons

Suksess

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

Valideringsfeil

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

Utilstrekkelig kreditter

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

API-nøkkel videoendepunkt (legacy)

Hvis du trenger API-tastbaserte videosamtaler, bruk /api/v1/generate/video/. Den veien støtter en begrenset modellsett og er dokumentert under eldre videokartlegging.

Åpne eldre videokartlegging Åpne statusarbeidsflyter Åpne videomodellmatrise