Vai al contenuto
UlazAI

Documenti per sviluppatori UlazAI

Studio video API

Prezzi Pannello di controllo Studio d'immagine
POST /api/v1/video-studio/generate/

Endpoint di generazione video canonico

Utilizza Video Studio per tutti i modelli video attuali. Questo endpoint supporta flussi di lavoro da testo a video, da immagine a video e specifici del modello come remix video.

Per le integrazioni dinamiche, recupera le funzionalità del modello da /api/v1/models/video/ prima di inviare i payload di generazione.

I percorsi recenti di Video Studio includono seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, e happyhorse_videoedit.
Autenticazione: invia Authorization: Bearer YOUR_API_KEY su ogni richiesta.

Sondaggio con /api/v1/video-studio/status/{job_id}/ e carica recente lavori da /api/v1/video-studio/history/.

Richiedi contratto

Campo Tipo Obbligatorio Note
model_slug stringa Sì Deve corrispondere a uno slug del modello Video Studio registrato
prompt stringa Di solito Richiesto per la maggior parte dei modelli. La modalità Storyboard può iniziare solo con le immagini.
aspect_ratio stringa No Deve essere una delle proporzioni del modello selezionato
duration_seconds intero No Deve corrispondere a una durata consentita per il modello. Motion Control utilizza la lunghezza del motion clip per determinare i prezzi.
quality_mode stringa No Obbligatorio quando il modello definisce le modalità di qualità
input_image_urls array[stringa] Specifico per il modello Utilizzato per i modelli da immagine a video. Alcuni modelli richiedono almeno un URL.
input_video_urls array[stringa] Specifico per il modello Utilizzato da remix video e percorsi video sorgente come wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, e happyhorse_videoedit.
seedance_mode stringa Solo semina 2 Utilizzare text_to_video, first_frame, first_last_frame, o multimodal.
first_frame_url, last_frame_url stringa Solo semina 2 Utilizzare per le modalità Seedance 2 primo fotogramma e primo+ultimo fotogramma. URL pubblici e asset:// Si accettano documenti d'identità.
reference_image_urls, reference_video_urls, reference_audio_urls array[stringa] Specifico per il modello Seedance 2 utilizza array di riferimento multimodali. Percorsi guidati da audio come video_lip_sync e omnihuman_1_5 utilizzare reference_audio_urls per il discorso o la voce fuori campo di destinazione. URL pubblici e asset:// Gli ID sono accettati laddove il modello selezionato li supporta.
character_orientation stringa Specifico per il modello Solo controllo del movimento. Utilizzare video per seguire l'orientamento del filmato o image per mantenere l'inquadratura del personaggio caricato, con durate da 3 a 15 secondi.
sound booleano No Utilizzato solo sui modelli con supporto audio
return_last_frame, web_search booleano Solo semina 2 Flag Seedance 2 opzionali per restituire l'ultimo fotogramma e abilitare la ricerca Web lato modello.
prompt_directory_optin booleano No Lo sconto Directory si applica solo alle famiglie di modelli selezionati
Per riprese di persone reali in Seedance 2, utilizza il file UlazAI Guida alle risorse di Seedance 2 e consegnare il reso asset:// ID. I file raw diretti potrebbero non riuscire.

Selettore del modello

Scegli un modello per ispezionare le funzionalità e generare automaticamente snippet di richiesta.

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.

Motore: Seedance 2.5

Rapporti d'aspetto: 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 secondi

Modalità di qualità: 480p, 720p, 1080p

Ingressi: testo , immagine , filmato

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

Snippet di richieste in tempo reale

I frammenti di seguito seguono la preimpostazione del modello selezionato.

cURL (chiave API)

JavaScript (recupera)

Python (richieste)

Snippet di polling sullo stato

Stato del sondaggio di job_id fino a quando completed o failed.

arricciatura

JavaScript (recupera)

Python (richieste)

Esempi di risposta

Successo

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

Errore di convalida

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

Crediti insufficienti

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

Endpoint video con chiave API (legacy)

Se hai bisogno di videochiamate basate sul tasto API, utilizza /api/v1/generate/video/. Quel percorso supporta a set di modelli limitato ed è documentato nella mappatura video legacy.

Apri la mappatura video legacy Apri i flussi di lavoro dello stato Apri la matrice del modello video