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.

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

Bildförhållanden: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

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

Kvalitetslägen: 480p, 720p, 1080p

Ingångar: text , bild , video

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

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