Vai al contenuto

Kling Video · v3 · Pro · Motion Control

Integra

ID del modello kling-video/v3/pro/motion-control
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 1,68 $ 1680 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Kling Da video a video Input di riferimento #stylized#transform#editing

Trasferimento del movimento di livello Pro che applica a un'immagine del personaggio i movimenti del personaggio in un video di riferimento

Kling · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

0 / 2500
•obbligatorio image_url
Trascina un file oppure

URL dell'immagine di riferimento per la generazione video, con un limite di 10.0MB per la dimensione del file, larghezza e altezza comprese tra 340px e 3850px e rapporto d'aspetto tra 0.40 e 2.50. Questa immagine guida i personaggi, gli sfondi e gli altri elementi del video. Per i personaggi, assicurati che le proporzioni del corpo siano chiare, che non vi siano occlusioni e che coprano più del 5% dell'area dell'immagine.

•obbligatorio video_url
Trascina un file oppure

URL che punta al video le cui azioni del personaggio guidano l'output; dovrebbe mostrare un personaggio in stile realistico e non ostruito, con la testa e il corpo intero o la parte superiore del corpo visibili. L'impostazione character_orientation limita la durata a 10s per 'image' o 30s per 'video'. Limiti del file: massimo 100 MB, larghezza e altezza comprese tra 340px e 3850px e durata tra 3.0s e 30.05s.

character_orientation •obbligatorio

Origine dell'orientamento del personaggio: 'image' corrisponde all'immagine di riferimento ed è migliore per seguire i movimenti della camera, con un massimo di 10 secondi. Per i movimenti complessi, 'video' è migliore: corrisponde all'orientamento del video di riferimento e consente fino a 30 secondi.

Avanzate enable_safety_checker · keep_original_sound · elements

Associazione facciale facoltativa per migliorare la conservazione dell'identità nel video in output, limitata a 1 elemento caricato. Usa @Element1 per richiamarlo nel prompt. L'associazione è disponibile solo con character_orientation impostato su 'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 preventivo → 1,68 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Kling Video · v3 · Pro · Motion Control

Combina un'immagine del personaggio in `image_url` con i movimenti di un video di riferimento in `video_url`. `character_orientation` è obbligatorio e sceglie se l'orientamento segue l'immagine o il video. È supportato un `prompt` facoltativo fino a 2500 caratteri, `keep_original_sound` mantiene l'audio di riferimento e un elemento facciale può essere associato tramite `elements` per aiutare a preservare l'identità.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
I controlli di sicurezza possono essere disabilitati solo con l'autorizzazione dell'account; le richieste senza autorizzazione vengono sempre verificate.
promptfacoltativo
Tipostring | null
≤ 2500 caratteri
image_urlobbligatorio image
Tipourl · image
URL dell'immagine di riferimento per la generazione video, con un limite di 10.0MB per la dimensione del file, larghezza e altezza comprese tra 340px e 3850px e rapporto d'aspetto tra 0.40 e 2.50. Questa immagine guida i personaggi, gli sfondi e gli altri elementi del video. Per i personaggi, assicurati che le proporzioni del corpo siano chiare, che non vi siano occlusioni e che coprano più del 5% dell'area dell'immagine.
video_urlobbligatorio video
Tipourl · video
URL che punta al video le cui azioni del personaggio guidano l'output; dovrebbe mostrare un personaggio in stile realistico e non ostruito, con la testa e il corpo intero o la parte superiore del corpo visibili. L'impostazione character_orientation limita la durata a 10s per 'image' o 30s per 'video'. Limiti del file: massimo 100 MB, larghezza e altezza comprese tra 340px e 3850px e durata tra 3.0s e 30.05s.
keep_original_soundfacoltativo
Tipoboolean
Predefinitotrue
Controlla il mantenimento del suono originale del video di riferimento.
character_orientationobbligatorio
Tipoenum
imagevideo
Origine dell'orientamento del personaggio: 'image' corrisponde all'immagine di riferimento ed è migliore per seguire i movimenti della camera, con un massimo di 10 secondi. Per i movimenti complessi, 'video' è migliore: corrisponde all'orientamento del video di riferimento e consente fino a 30 secondi.
elementsfacoltativo
Tipoobject[]
Associazione facciale facoltativa per migliorare la conservazione dell'identità nel video in output, limitata a 1 elemento caricato. Usa @Element1 per richiamarlo nel prompt. L'associazione è disponibile solo con character_orientation impostato su 'video'.
elements[].frontal_image_urlfacoltativo
Tipourl · image
Immagine frontale che mostra la vista principale dell'elemento. La dimensione del file non deve superare 50 MB; larghezza e altezza devono essere di almeno 300px ciascuna, con un rapporto d'aspetto compreso tra 0.40 e 2.50.
elements[].reference_image_urlsfacoltativo
Tipourl[] · image
Fornisci 1–3 immagini di riferimento aggiuntive che mostrino angolazioni diverse. Ogni immagine deve avere un rapporto d'aspetto compreso tra 0.40 e 2.50, misurare almeno 300px in entrambe le dimensioni e non superare 50.0MB.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v3/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1680,
    "usd": "1.68",
    "charged": 1680,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}Video prodotto dal modello.

Altri modelli: Da video a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/kling-video/v3/pro/motion-control.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt