kling-v3-omni. Combina un prompt richiesto con fotogrammi iniziale e finale, immagini di riferimento o un video di riferimento, quindi traccia il risultato asincrono tramite img_uuid.API Kling 3.0 Omni per la Generazione Video Multimodale
Accedi a Kling 3.0 Omni tramite GoEnhance con il modello
Ottieni Chiave API
Un endpoint per riferimenti di prompt, immagini e video
Indirizza i materiali di riferimento all'interno del prompt
Le immagini sono numerate da @image_1 in poi nell'ordine: fotogramma iniziale, fotogramma finale e poi ref_imgs. Un video di riferimento è @video_1, quindi l'ordinamento stabile dell'array mantiene deterministici i riferimenti del prompt.
Usa il comportamento della funzione o del video di riferimento base
Con video_type: feature, l'output segue il movimento e lo stile del riferimento; la generazione audio viene rifiutata e il multi-shot è forzato. Con base, il video sorgente viene modificato sul posto, i fotogrammi iniziale/finale e il multi-shot non sono disponibili e l'audio esistente viene conservato.
Convalida le combinazioni specifiche del ruolo prima di accodare un'attività di generazione.
Funzionalità e regole di convalida dell'API Kling 3.0 Omni
Modello e prompt
POST su <code>https://api.goenhance.ai/api/v1/videos/generations</code> con <code>model: kling-v3-omni</code> obbligatorio e un <code>prompt</code> obbligatorio.
Fotogrammi iniziale e finale
Usa <code>image_url</code> per un fotogramma iniziale. <code>image_end_url</code> richiede quel fotogramma iniziale; le richieste solo per il fotogramma finale non sono supportate.
Immagini di riferimento
Passa i valori <code>ref_imgs</code> ordinati e fai riferimento a essi con <code>@image_N</code>. È accettato anche l'alias compatibile <code>image_urls</code>.
Video di riferimento
Passa al massimo un file MP4 o MOV da 3 a 15,5 secondi tramite <code>ref_videos</code>. <code>video_url</code> è un alias compatibile.
Controlli di output
Scegli una durata intera da 3 a 15 secondi, risoluzione 720p/1080p/4K e rapporto 16:9, 9:16 o 1:1 quando nessun fotogramma iniziale o video di riferimento determina il rapporto.
Limiti di materiale
Il fotogramma iniziale, il fotogramma finale e le immagini di riferimento possono totalizzare fino a sette materiali, o fino a quattro quando è incluso un video di riferimento.
Il prezzo si intende per secondo generato e dipende dalla risoluzione, dall'uso di un video di riferimento e dall'audio nativo.
Prezzi API di Kling 3.0 Omni
720p · nessun video, nessun audio
4,2 token per secondo generato ($0,084/s).
720p · audio nativo
5,6 token per secondo generato ($0,112/s) quando non c'è un video di riferimento.
720p · con video di riferimento
6,3 token per secondo generato ($0,126/s).
Livelli 1080p
5,6 token/s ($0,112/s) senza video o audio, 7 token/s ($0,14/s) con audio nativo e senza video, oppure 8,4 token/s ($0,168/s) con un video di riferimento.
4K
21 token al secondo generato ($0,42/s) negli scenari documentati senza audio, con audio nativo e con video di riferimento.
Stima ogni richiesta
Moltiplica la durata richiesta per la tariffa esatta in base alla risoluzione selezionata, all'uso di un video di riferimento e alla modalità audio. Gli equivalenti in USD utilizzano i $0,02 per token documentati.
Integra Kling 3.0 Omni in sei passaggi
1
1. Crea una chiave API
Crea una chiave API GoEnhance e inviala nell'intestazione
Authorization. 2
2. Seleziona il modello
Imposta
model su kling-v3-omni e scrivi un prompt che faccia riferimento esplicito a qualsiasi materiale @image_N o @video_1. 3
3. Convalida i materiali
Controlla le dipendenze dei fotogrammi, il conteggio dei materiali, la durata del video di riferimento e le restrizioni per la modalità
feature o base. 4
4. Invia l'attività
Invia la richiesta tramite POST a
/api/v1/videos/generations e conserva l'img_uuid restituito. 5
5. Monitora il completamento
Esegui il polling di
GET /api/v1/jobs/detail o fornisci un custom_callback_url HTTPS accessibile pubblicamente. 6
6. Gestisci gli stati terminali
Elabora successo e fallimento in modo idempotente. I ricevitori di callback che non restituiscono un HTTP 200 possono essere riprovati fino a tre volte con un timeout di tre secondi per tentativo.
Costruisci flussi di lavoro video multimodali basati su ruoli di input espliciti e riferimenti materiali deterministici.
Casi d'uso per sviluppatori di Kling 3.0 Omni
Clip di campagna basate su riferimenti
Combina fotogrammi chiave approvati e riferimenti visivi con modelli di prompt controllati per varianti di campagna ripetibili.
Studi sul movimento del prodotto
Utilizza un primo fotogramma o immagini di riferimento ordinate per esplorare il movimento del prodotto mentre l'applicazione gestisce la convalida e le approvazioni delle risorse.
Pipeline di restyling video
Utilizza un video di riferimento delle caratteristiche quando il movimento e lo stile devono guidare un nuovo output, soggetto alle sue regole audio e multi-inquadratura.
Modifiche video di base
Utilizza la modalità base quando un video esistente deve essere modificato direttamente mantenendo l'audio originale.
Transizioni di storyboard
Utilizza gli input del primo e dell'ultimo fotogramma per pianificare una transizione tra battute visive approvate senza modificare l'orchestrazione del lavoro.
Automazione creativa localizzata
Parametrizza i prompt e i riferimenti ai materiali per le varianti regionali riutilizzando lo stesso gestore di attività asincrone.
Risposte pratiche per la convalida delle richieste, i prezzi, i riferimenti e il completamento asincrono.