Gå til indhold
UlazAI

UlazAI udviklerdokumenter

Videostudie API

Prissætning Dashboard Billedstudie
POST /api/v1/video-studio/generate/

Kanonisk videogenereringsslutpunkt

Brug Video Studio til alle aktuelle videomodeller. Dette endepunkt understøtter tekst-til-video, billede-til-video og modelspecifikke arbejdsgange som f.eks video remix.

For dynamiske integrationer skal du hente modelfunktioner fra /api/v1/models/video/ før du sender generationsnyttelast.

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.
Godkendelse: send Authorization: Bearer YOUR_API_KEY på hver anmodning.

Afstemning med /api/v1/video-studio/status/{job_id}/ og indlæs seneste job fra /api/v1/video-studio/history/.

Anmod om kontrakt

Felt Type Påkrævet Noter
model_slug streng Ja Skal matche en registreret Video Studio-modelsnegl
prompt streng Normalt Påkrævet til de fleste modeller. Storyboard-tilstand kan kun starte med billeder.
aspect_ratio streng Nej Skal være et af den valgte models billedformat
duration_seconds heltal Nej Skal matche en tilladt varighed for modellen. Motion Control bruger bevægelsesklipslængden til prisfastsættelse.
quality_mode streng Nej Påkrævet, når modellen definerer kvalitetstilstande
input_image_urls matrix[streng] Modelspecifik Anvendes til billed-til-video-modeller. Nogle modeller kræver mindst én URL.
input_video_urls matrix[streng] Modelspecifik Bruges af video-remix 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 Brug text_to_video, first_frame, first_last_frame, eller multimodal.
first_frame_url, last_frame_url streng Kun Seedance 2 Bruges til første-frame og første+sidste-frame Seedance 2-tilstande. Offentlige URL'er og asset:// ID'er accepteres.
reference_image_urls, reference_video_urls, reference_audio_urls matrix[streng] Modelspecifik Seedance 2 bruger multimodale referencearrays. Lyddrevne ruter som f.eks video_lip_sync og omnihuman_1_5 bruge reference_audio_urls til måltalen eller voiceoveren. Offentlige URL'er og asset:// ID'er accepteres, hvor den valgte model understøtter dem.
character_orientation streng Modelspecifik Kun bevægelseskontrol. Brug video for at følge bevægelsesklips-retningen eller image for at beholde den uploadede karakterramme med varigheder fra 3 til 15 sekunder.
sound boolesk Nej Bruges kun på modeller med lydunderstøttelse
return_last_frame, web_search boolesk Kun Seedance 2 Valgfri Seedance 2-flag til at returnere det sidste billede og aktivere websøgning på modelsiden.
prompt_directory_optin boolesk Nej Directory-rabat gælder kun udvalgte modelfamilier
Til optagelser fra virkelige personer i Seedance 2 skal du bruge UlazAI Seedance 2 aktivguide og videregive den returnerede asset:// ID. Direkte råfiler kan mislykkes.

Modelvælger

Vælg en model for at inspicere muligheder og automatisk generere anmodningsuddrag.

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

Størrelsesforhold: 16:9, 9:16, auto

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

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

Indgange: billede , video

Credits: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Uddrag af direkte anmodninger

Uddrag nedenfor følger den valgte modelforudindstilling.

cURL (API nøgle)

JavaScript (hent)

Python (anmodninger)

Uddrag af statusafstemning

Afstemningsstatus af job_id indtil completed eller failed.

krølle

JavaScript (hent)

Python (anmodninger)

Eksempler på svar

Succes

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

Valideringsfejl

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

Utilstrækkelige kreditter

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

API-nøgle videoslutpunkt (legacy)

Hvis du har brug for API-tastbaserede videoopkald, så brug /api/v1/generate/video/. Den vej understøtter en begrænset modelsæt og er dokumenteret under legacy video mapping.

Åbn ældre videokortlægning Åbne status arbejdsgange Åbn videomodelmatrix