model: kling-v3-motion. Fornisci riferimenti per l'aspetto e il movimento, invia una richiesta asincrona e traccia l'img_uuid restituito tramite polling o callback.API per il controllo del movimento Kling V3 per video di personaggi guidati da riferimento
Accedi a Kling V3 Motion Control tramite GoEnhance con
Ottieni chiave API
Combina riferimenti di aspetto e movimento in un'unica richiesta
Definisci l'aspetto del personaggio
Usa image_url per un'immagine chiara del personaggio a mezzo busto o figura intera, oppure usa al massimo un elemento Kling tramite element_ids. L'input dell'elemento forza character_orientation: video.
Trasferisci il movimento da un video di riferimento
Fornisci un file MP4 o MOV richiesto in video_url. L'output segue il movimento continuo utilizzabile da quel file; questo endpoint non ha un parametro duration.
Convalida i media prima dell'invio; i valori di durata o risoluzione non supportati devono essere rifiutati lato client.
Funzionalità e regole di convalida dell'API per il controllo del movimento Kling V3
Endpoint e modello
POST su <code>https://api.goenhance.ai/api/v1/videos/generations</code> con <code>model: kling-v3-motion</code>.
Prompt
Invia un <code>prompt</code> richiesto fino a 2.500 caratteri per descrivere il personaggio, l'abbigliamento, la scena o la direzione di generazione pertinente.
Input aspetto
Un <code>image_url</code> può essere JPG, JPEG o PNG, fino a 50 MB, almeno 300 px per lato, con un rapporto d'aspetto da 1:2.5 a 2.5:1.
Input movimento
Il <code>video_url</code> richiesto deve essere MP4 o MOV, non superiore a 100 MB, con dimensioni da 340 a 3.850 px.
Orientamento e durata
<code>character_orientation: video</code> accetta da 3 a 30 secondi; <code>image</code> accetta da 3 a 10 secondi. L'impostazione predefinita documentata è <code>video</code>.
Risoluzione e audio
Scegli 720p o 1080p; non esiste un livello 4K. <code>generate_audio</code> mantiene l'audio originale del video di movimento ed è impostato su false per impostazione predefinita.
Il prezzo è per secondo generato, mentre GoEnhance misura la lunghezza del video di movimento in input come addebito massimo della richiesta.
Prezzi dell'API Kling V3 Motion Control
Tariffa 720p
6,3 token per secondo generato, equivalenti a $0,126/s al costo documentato di $0,02 per token.
Tariffa 1080p
8,4 token per secondo generato, equivalenti a $0,168/s al costo documentato di $0,02 per token.
Stima dei costi
Stima il costo massimo della richiesta come la durata misurata del video di movimento moltiplicata per la tariffa esatta per la risoluzione selezionata.
Fatturazione basata sull'input misurato
GoEnhance trasferisce e misura <code>video_url</code> prima di detrarre i token, pertanto la modifica del file remoto dopo la misurazione non altera l'input fatturato.
L'output potrebbe essere più breve
Kling estrae un movimento continuo utilizzabile, quindi movimenti difficili o molto rapidi possono produrre un output più breve rispetto al video di riferimento.
Nessun parametro di durata
Non inviare <code>duration</code>; l'endpoint lo rifiuta e la lunghezza dell'output segue il movimento utilizzabile estratto dal video di riferimento.
Integra il controllo del movimento di Kling V3 in sei passaggi
1
1. Crea una chiave API
Crea una chiave API GoEnhance e inviala nell'intestazione
Authorization. 2
2. Convalida entrambi i riferimenti
Controlla la nitidezza e le dimensioni dell'immagine, quindi verifica il formato, le dimensioni e la lunghezza dipendente dall'orientamento del video di movimento.
3
3. Invia e rendi persistente l'attività
Invia la richiesta tramite POST con
model: kling-v3-motion, quindi salva l'img_uuid restituito prima di affidare il lavoro a un processore in background. 4
4. Monitora lo stato
Esegui il polling di
GET /api/v1/jobs/detail o fornisci un custom_callback_url HTTPS accessibile pubblicamente. 5
5. Gestisci i callback in modo idempotente
Gestisci gli eventi di stato ripetuti in modo sicuro. Un callback che non restituisce HTTP 200 può essere ritentato fino a tre volte con un timeout di tre secondi per tentativo.
6
6. Archivia il risultato finale
Separa l'elaborazione, il successo e la gestione degli errori, e salva l'URL del video finale solo dopo che l'attività ha raggiunto uno stato terminale.
Utilizza contenuti multimediali che sei autorizzato a elaborare e progetta per un completamento asincrono.
Casi d'uso per sviluppatori per Kling V3 Motion Control
Clip di performance dei personaggi
Applica riferimenti di movimento approvati a un aspetto coerente del personaggio per pipeline di video narrativi o promozionali brevi.
Anteprime di danza e coreografia
Trasferisci il movimento di prova con licenza in anteprime guidate dai personaggi, preservando il consenso e i diritti sull'audio sorgente.
Concetti di animazione dei personaggi di gioco
Genera studi di movimento dall'arte del personaggio e dal movimento registrato prima di impegnarti in un flusso di lavoro di animazione completo.
Varianti di campagne localizzate
Parametrizza i prompt e gli input di aspetto per varianti creative regionali riutilizzando un unico livello di orchestrazione dei processi.
Flussi di lavoro per performer virtuali
Costruisci pipeline di performer controllate attorno a riferimenti di immagini, risorse di movimento e impostazioni di orientamento approvati.
Previsualizzazione
Verifica se un riferimento di movimento è adatto a un personaggio prima dell'editing, del compositing e della revisione a valle.
Risposte a domande comuni su integrazione, prezzi, convalida e API Kuaishou.