Naar inhoud
UlazAI

UlazAI ontwikkelaarsdocumentatie

Videostudio API

Prijzen Dashboard Beeldstudio
POST /api/v1/video-studio/generate/

Canonisch eindpunt voor het genereren van video's

Gebruik Video Studio voor alle huidige videomodellen. Dit eindpunt ondersteunt tekst-naar-video, afbeelding-naar-video en modelspecifieke workflows zoals video-remix.

Voor dynamische integraties haalt u modelmogelijkheden op van /api/v1/models/video/ voordat generatiepayloads worden verzonden.

Recente Video Studio-routes omvatten seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, en happyhorse_videoedit.
Authenticatie: verzenden Authorization: Bearer YOUR_API_KEY op elk verzoek.

Enquête met /api/v1/video-studio/status/{job_id}/ en laad recent banen van /api/v1/video-studio/history/.

Contract aanvragen

Veld Typ Vereist Opmerkingen
model_slug touwtje Ja Moet overeenkomen met een geregistreerde Video Studio-modelslug
prompt touwtje Meestal Vereist voor de meeste modellen. De Storyboard-modus kan alleen met afbeeldingen beginnen.
aspect_ratio touwtje Nee Moet een van de beeldverhoudingen van het geselecteerde model zijn
duration_seconds geheel getal Nee Moet overeenkomen met een toegestane duur voor het model. Motion Control gebruikt de lengte van de bewegingsclip voor de prijsstelling.
quality_mode touwtje Nee Vereist wanneer het model kwaliteitsmodi definieert
input_image_urls array[tekenreeks] Modelspecifiek Gebruikt voor beeld-naar-video-modellen. Voor sommige modellen is minimaal één URL vereist.
input_video_urls array[tekenreeks] Modelspecifiek Gebruikt door videoremix en bron-videoroutes zoals wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, en happyhorse_videoedit.
seedance_mode touwtje Alleen Seedance 2 Gebruik text_to_video, first_frame, first_last_frame, of multimodal.
first_frame_url, last_frame_url touwtje Alleen Seedance 2 Gebruik deze voor de Seedance 2-modi eerste frame en eerste+laatste frame. Openbare URL's en asset:// ID's worden geaccepteerd.
reference_image_urls, reference_video_urls, reference_audio_urls array[tekenreeks] Modelspecifiek Seedance 2 maakt gebruik van multimodale referentiearrays. Audiogestuurde routes zoals video_lip_sync en omnihuman_1_5 gebruik reference_audio_urls voor de doeltoespraak of voice-over. Openbare URL's en asset:// ID's worden geaccepteerd als het geselecteerde model deze ondersteunt.
character_orientation touwtje Modelspecifiek Alleen bewegingsbediening. Gebruik video om de oriëntatie van de bewegingsclip te volgen of image om de geüploade karakterframing te behouden, met een duur van 3 tot 15 seconden.
sound Booleaans Nee Alleen gebruikt op modellen met audio-ondersteuning
return_last_frame, web_search Booleaans Alleen Seedance 2 Optionele Seedance 2-vlaggen voor het retourneren van het laatste frame en het inschakelen van webzoeken op het model.
prompt_directory_optin Booleaans Nee Folderkorting geldt alleen voor geselecteerde modelfamilies
Voor beelden van echte personen in Seedance 2 gebruik je de UlazAI Seedance 2 activagids en geef de geretourneerde door asset:// asset-ID. Directe RAW-bestanden kunnen mislukken.

Modelkiezer

Kies een model om de mogelijkheden te inspecteren en automatisch verzoekfragmenten te genereren.

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

Beeldverhoudingen: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Duur: 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 seconden

Kwaliteitsmodi: 480p, 720p, 1080p

Ingangen: tekst , afbeelding , filmpje

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

Fragmenten van liveverzoeken

De onderstaande fragmenten volgen de geselecteerde modelvoorinstelling.

cURL (API-sleutel)

JavaScript (ophalen)

Python (verzoeken)

Status polling-fragmenten

Poll-status door job_id tot completed of failed.

krul

JavaScript (ophalen)

Python (verzoeken)

Reactievoorbeelden

Succes

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

Validatiefout

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

Onvoldoende kredieten

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

API-sleutel video-eindpunt (verouderd)

Als u videogesprekken op basis van API-toetsen nodig heeft, gebruikt u /api/v1/generate/video/. Dat pad ondersteunt a beperkte modellenset en is gedocumenteerd onder oudere videomapping.

Open oudere videomapping Statusworkflows openen Open de videomodelmatrix