Sari la conținut
UlazAI

UlazAI documente pentru dezvoltatori

Studio video API

Prețuri Bord Studio de imagine
POSTĂ /api/v1/video-studio/generate/

Punct final de generare video canonică

Utilizați Video Studio pentru toate modelele video actuale. Acest punct final acceptă fluxuri de lucru text-to-video, imagine-video și specifice modelului, cum ar fi remix video.

Pentru integrări dinamice, preluați capabilitățile modelului de la /api/v1/models/video/ înainte de a trimite încărcături utile de generație.

Rutele recente Video Studio includ seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, și happyhorse_videoedit.
Autentificare: trimite Authorization: Bearer YOUR_API_KEY la fiecare cerere.

Sondaj cu /api/v1/video-studio/status/{job_id}/ și încărcați recent locuri de munca de la /api/v1/video-studio/history/.

Solicitați contract

Câmp Tip Necesar Note
model_slug sfoară Da Trebuie să se potrivească cu un model slug înregistrat de Video Studio
prompt sfoară De obicei Necesar pentru majoritatea modelelor. Modul Storyboard poate începe doar cu imagini.
aspect_ratio sfoară Nu Trebuie să fie unul dintre raporturile de aspect ale modelului selectat
duration_seconds întreg Nu Trebuie să se potrivească cu o durată permisă pentru model. Motion Control folosește lungimea clipului de mișcare pentru stabilirea prețurilor.
quality_mode sfoară Nu Necesar atunci când modelul definește moduri de calitate
input_image_urls matrice[șir] Specific modelului Folosit pentru modele imagine-video. Unele modele necesită cel puțin o adresă URL.
input_video_urls matrice[șir] Specific modelului Folosit de remixuri video și rute video sursă, cum ar fi wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, și happyhorse_videoedit.
seedance_mode sfoară Numai Seedance 2 Utilizați text_to_video, first_frame, first_last_frame, sau multimodal.
first_frame_url, last_frame_url sfoară Numai Seedance 2 Utilizați pentru modurile Seedance 2 primul cadru și primul + ultimul cadru. URL-uri publice și asset:// Actele de identitate sunt acceptate.
reference_image_urls, reference_video_urls, reference_audio_urls matrice[șir] Specific modelului Seedance 2 folosește tablouri de referință multimodale. Rute conduse de audio, cum ar fi video_lip_sync şi omnihuman_1_5 folosi reference_audio_urls pentru discursul țintă sau vocea off. URL-uri publice și asset:// ID-urile sunt acceptate acolo unde modelul selectat le acceptă.
character_orientation sfoară Specific modelului Numai Motion Control. Utilizați video pentru a urma orientarea clipului de mișcare sau image pentru a păstra încadrarea caracterului încărcat, cu durate de la 3 la 15 secunde.
sound boolean Nu Folosit numai pe modelele cu suport audio
return_last_frame, web_search boolean Numai Seedance 2 Indicatori opționali Seedance 2 pentru returnarea ultimului cadru și activarea căutării web pe partea modelului.
prompt_directory_optin boolean Nu Reducerea directorului se aplică numai familiilor de modele selectate
Pentru imagini cu persoane reale în Seedance 2, utilizați UlazAI Ghid de active Seedance 2 și treci pe cel întors asset:// ID. Fișierele brute directe pot eșua.

Selector de model

Alegeți un model pentru a inspecta capabilitățile și pentru a genera automat fragmente de solicitare.

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

Raport de aspect: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Durate: 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 secunde

Moduri de calitate: 480p, 720p, 1080p

Intrări: text , imagine , video

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

Fragmente de solicitare live

Fragmentele de mai jos urmează modelul presetat selectat.

cURL (tasta API)

JavaScript (preluare)

Python (cereri)

Fragmente de sondaj de stare

Starea sondajului de către job_id până când completed sau failed.

cURL

JavaScript (preluare)

Python (cereri)

Exemple de răspuns

Succes

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

Eroare de validare

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

Credite insuficiente

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

Punct final video API-key (moștenire)

Dacă aveți nevoie de apeluri video bazate pe tasta API, utilizați /api/v1/generate/video/. Acea cale susține a set de modele limitate și este documentat în mapping video moștenit.

Deschideți maparea video moștenită Deschideți fluxurile de lucru de stare Deschideți matricea modelului video