Hoppa till innehållet
UlazAI

UlazAI utvecklardokument

Videostudio API

Prissättning Instrumentbräda Bildstudio
POST /api/v1/video-studio/generate/

Kanonisk videogenereringsslutpunkt

Använd Video Studio för alla aktuella videomodeller. Denna slutpunkt stöder text-till-video, bild-till-video, och modellspecifika arbetsflöden som t.ex videoremix.

För dynamiska integrationer, hämta modellfunktioner från /api/v1/models/video/ innan genereringsnyttolaster skickas.

Nya Video Studio rutter inkluderar seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, och happyhorse_videoedit.
Autentisering: skicka Authorization: Bearer YOUR_API_KEY på varje begäran.

Omröstning med /api/v1/video-studio/status/{job_id}/ och ladda senaste jobb från /api/v1/video-studio/history/.

Begär kontrakt

Fält Typ Obligatoriskt Anteckningar
model_slug sträng Ja Måste matcha en registrerad Video Studio-modell
prompt sträng Vanligtvis Krävs för de flesta modeller. Storyboard-läget kan endast starta med bilder.
aspect_ratio sträng Nej Måste vara ett av den valda modellens bildproportioner
duration_seconds heltal Nej Måste matcha en tillåten varaktighet för modellen. Motion Control använder rörelseklippets längd för prissättning.
quality_mode sträng Nej Krävs när modellen definierar kvalitetslägen
input_image_urls array[sträng] Modellspecifik Används för bild-till-video-modeller. Vissa modeller kräver minst en webbadress.
input_video_urls array[sträng] Modellspecifik Används av videoremix och källvideorutter som t.ex wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, och happyhorse_videoedit.
seedance_mode sträng Endast Seedance 2 Använd text_to_video, first_frame, first_last_frame, eller multimodal.
first_frame_url, last_frame_url sträng Endast Seedance 2 Används för lägena första bildruta och första+sista bildruta Seedance 2. Offentliga webbadresser och asset:// ID-kort accepteras.
reference_image_urls, reference_video_urls, reference_audio_urls array[sträng] Modellspecifik Seedance 2 använder multimodala referensmatriser. Ljuddrivna rutter som t.ex video_lip_sync och omnihuman_1_5 använda reference_audio_urls för måltalet eller voiceover. Offentliga webbadresser och asset:// ID:n accepteras där den valda modellen stöder dem.
character_orientation sträng Modellspecifik Endast rörelsekontroll. Använda video för att följa rörelseklippets orientering eller image för att behålla den uppladdade teckenramningen, med varaktigheter från 3 till 15 sekunder.
sound booleskt Nej Används endast på modeller med ljudstöd
return_last_frame, web_search booleskt Endast Seedance 2 Valfria Seedance 2-flaggor för att returnera den sista bilden och möjliggöra webbsökning på modellsidan.
prompt_directory_optin booleskt Nej Katalograbatt gäller endast utvalda modellfamiljer
För bilder från verkliga personer i Seedance 2, använd UlazAI Seedance 2 tillgångsguide och passera den returnerade asset:// ID. Direkta råfiler kan misslyckas.

Modellväljare

Välj en modell för att inspektera funktioner och automatiskt generera förfrågningsavsnitt.

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

Bildförhållanden: 16:9, 9:16, auto

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

Kvalitetslägen: 360p, 720p, 1080p, 4k

Ingångar: bild , video

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

Liveförfrågningsavsnitt

Utdrag nedan följer den valda modellens förinställning.

cURL (API-nyckel)

JavaScript (hämta)

Python (förfrågningar)

Utdrag från statusundersökningar

Omröstningsstatus av job_id tills completed eller failed.

curL

JavaScript (hämta)

Python (förfrågningar)

Exempel på svar

Framgång

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

Valideringsfel

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

Otillräckliga krediter

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

API-nyckel videoslutpunkt (legacy)

Om du behöver API-nyckelbaserade videosamtal, använd /api/v1/generate/video/. Den vägen stöder en begränsad modelluppsättning och är dokumenterad under äldre videokartläggning.

Öppna äldre videokartläggning Öppna statusarbetsflöden Öppna videomodellmatris