Przejdź do treści
UlazAI

Dokumentacja programisty UlazAI

Studio wideo API

Wycena Panel Pracownia obrazu
POST /api/v1/video-studio/generate/

Kanoniczny punkt końcowy generowania wideo

Użyj Video Studio dla wszystkich aktualnych modeli wideo. Ten punkt końcowy obsługuje tekst na wideo, obraz na wideo i przepływy pracy specyficzne dla modelu, takie jak remiks wideo.

W przypadku integracji dynamicznej pobierz możliwości modelu z /api/v1/models/video/ przed wysłaniem ładunków generacji.

Najnowsze trasy Video Studio obejmują 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.
Uwierzytelnianie: wyślij Authorization: Bearer YOUR_API_KEY na każde żądanie.

Ankieta z /api/v1/video-studio/status/{job_id}/ i załaduj najnowsze prace od /api/v1/video-studio/history/.

Poproś o umowę

Pole Typ Wymagane Notatki
model_slug ciąg Tak Musi pasować do zarejestrowanego ślimaka modelu Video Studio
prompt ciąg Zwykle Wymagane w przypadku większości modeli. Tryb scenorysu można rozpocząć tylko od obrazów.
aspect_ratio ciąg Nie Musi to być jeden ze współczynników proporcji wybranego modelu
duration_seconds liczba całkowita Nie Musi odpowiadać dozwolonemu czasowi trwania modelu. Sterowanie ruchem wykorzystuje długość klipu ruchomego do wyceny.
quality_mode ciąg Nie Wymagane, gdy model definiuje tryby jakości
input_image_urls tablica[ciąg] Specyficzne dla modelu Używany w modelach obrazu do wideo. Niektóre modele wymagają co najmniej jednego adresu URL.
input_video_urls tablica[ciąg] Specyficzne dla modelu Używany w remiksach wideo i trasach źródłowo-wideo, takich jak wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, i happyhorse_videoedit.
seedance_mode ciąg Tylko Seedance 2 Użyj text_to_video, first_frame, first_last_framelub multimodal.
first_frame_url, last_frame_url ciąg Tylko Seedance 2 Używaj dla trybów Seedance 2 pierwszej klatki i pierwszej + ostatniej klatki. Publiczne adresy URL i asset:// Akceptowane są dokumenty tożsamości.
reference_image_urls, reference_video_urls, reference_audio_urls tablica[ciąg] Specyficzne dla modelu Seedance 2 wykorzystuje multimodalne tablice referencyjne. Trasy sterowane dźwiękiem, takie jak video_lip_sync i omnihuman_1_5 używać reference_audio_urls dla docelowej mowy lub lektora. Publiczne adresy URL i asset:// Identyfikatory są akceptowane tam, gdzie wybrany model je obsługuje.
character_orientation ciąg Specyficzne dla modelu Tylko sterowanie ruchem. Użyj video aby podążać za orientacją klipu ruchomego lub image aby zachować kadrowanie przesłanej postaci, o czasie trwania od 3 do 15 sekund.
sound wartość logiczna Nie Używany tylko w modelach z obsługą dźwięku
return_last_frame, web_search wartość logiczna Tylko Seedance 2 Opcjonalne flagi Seedance 2 do zwracania ostatniej klatki i włączania wyszukiwania w sieci po stronie modelu.
prompt_directory_optin wartość logiczna Nie Rabat katalogowy dotyczy tylko wybranych rodzin modeli
W przypadku nagrań z udziałem prawdziwych osób w Seedance 2 użyj opcji Przewodnik po zasobach UlazAI Seedance 2 i przekazać zwrócone asset:// Identyfikator. Bezpośrednie pliki surowe mogą się nie powieść.

Selektor modelu

Wybierz model, aby sprawdzić możliwości i automatycznie wygenerować fragmenty żądań.

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.

Silnik: Gemini Omni

Proporcje obrazu: 16:9, 9:16, auto

Czas trwania: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 sekundy

Tryby jakości: 360p, 720p, 1080p, 4k

Wejścia: obraz , wideo

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

Fragmenty żądań na żywo

Poniższe fragmenty odpowiadają wybranemu wstępnemu modelowi.

cURL (klucz API)

JavaScript (pobierz)

Python (żądania)

Fragmenty sondowania stanu

Stan ankiety według job_id aż completed lub failed.

ZWIŃ

JavaScript (pobierz)

Python (żądania)

Przykłady odpowiedzi

Sukces

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

Błąd walidacji

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

Niewystarczające kredyty

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

Punkt końcowy wideo z kluczem API (starsza wersja)

Jeśli potrzebujesz połączeń wideo opartych na kluczu API, użyj /api/v1/generate/video/. Ta ścieżka obsługuje a ograniczony zestaw modeli i jest udokumentowany w ramach starszego mapowania wideo.

Otwórz starsze mapowanie wideo Przepływy pracy ze stanem otwartym Otwórz matrycę modelu wideo