API per il controllo del movimento Kling V3 per video di personaggi guidati da riferimento

Accedi a Kling V3 Motion Control tramite GoEnhance con 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.
Ottieni chiave API
Produzione cinematografica con riferimento al movimento per l'API per il controllo del movimento Kling V3

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.
Fotografia controllata con riferimento all'aspetto per la generazione di video di personaggi

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.
Prova di coreografia per una singola scena utilizzata come riferimento di movimento
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 https://api.goenhance.ai/api/v1/videos/generations con model: kling-v3-motion.

Prompt

Invia un prompt richiesto fino a 2.500 caratteri per descrivere il personaggio, l'abbigliamento, la scena o la direzione di generazione pertinente.

Input aspetto

Un image_url 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 video_url richiesto deve essere MP4 o MOV, non superiore a 100 MB, con dimensioni da 340 a 3.850 px.

Orientamento e durata

character_orientation: video accetta da 3 a 30 secondi; image accetta da 3 a 10 secondi. L'impostazione predefinita documentata è video.

Risoluzione e audio

Scegli 720p o 1080p; non esiste un livello 4K. generate_audio 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 video_url 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 duration; 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.
Ottieni chiave API
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.

Domande frequenti sull'API di controllo del movimento Kling V3

Qual è l'endpoint dell'API Kling V3 Motion Control?

Invia tramite GoEnhance all'indirizzo POST https://api.goenhance.ai/api/v1/videos/generations con model: kling-v3-motion. La risposta restituisce un img_uuid.

Come funziona il prezzo dell'API Kling V3 Motion Control?

Il formato 720p costa 6,3 token/s ($0,126/s), mentre il 1080p costa 8,4 token/s ($0,168/s). GoEnhance misura la durata del video in movimento prima della detrazione come addebito massimo della richiesta.

Posso inviare un parametro di durata?

No. Questo endpoint rifiuta duration. Il video di riferimento deve soddisfare i limiti specifici dell'orientamento e l'output segue il movimento continuo utilizzabile estratto da esso.

Cosa modifica character_orientation?

video segue la direzione di orientamento nel video in movimento e consente da 3 a 30 secondi. image segue l'immagine di aspetto e consente da 3 a 10 secondi.

L'API può generare audio nativo?

No. generate_audio mantiene solo la colonna sonora originale del video in movimento. L'impostazione predefinita è false; usa l'audio solo se disponi dei diritti necessari.

Posso usare un elemento Kling al posto di un'immagine?

Il percorso V3 accetta al massimo un valore tramite element_ids (o l'alias a valore singolo element_id). L'input dell'elemento forza character_orientation: video.

Come funzionano i callback?

Fornisci un custom_callback_url HTTPS pubblico. Il corpo del callback corrisponde alla risposta dei dettagli del lavoro; le consegne non con codice 200 possono essere ritentate fino a tre volte con un timeout di tre secondi.

Questa è l'API ufficiale di Kuaishou?

No. Kling è associato a Kuaishou, ma questa pagina descrive l'accesso indipendente tramite GoEnhance. GoEnhance non viene presentata come l'API, il partner o lo sviluppatore di modelli ufficiale di Kuaishou o Kling.

Sviluppa con l'API di controllo del movimento Kling V3