Hopp til innholdet

UlazAI utviklerdokumenter

Videostudio API

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.

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

Sideforhold: 16:9, 9:16, auto

Varighet: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 sekunder

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

Innganger: bilde , video

Kreditt: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 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