Passer au contenu

Kling Video · v3 · Pro · Motion Control

Intégrer

Identifiant du modèle 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"

Fichiers comme dans l’exemple: 1,68 $ 1 680 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Kling Vidéo vers vidéo Entrées de référence #stylized#transform#editing

Transfert de mouvement de niveau Pro appliquant les mouvements d'un personnage dans une vidéo de référence à une image de personnage

Kling · Vidéo

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

0 / 2500
•requis image_url
Déposez un fichier, ou

URL de l'image de référence pour la génération vidéo, avec une taille de fichier maximale de 10.0MB, une largeur et une hauteur comprises entre 340px et 3850px, et un rapport hauteur-largeur compris entre 0.40 et 2.50. Cette image guide les personnages, arrière-plans et autres éléments de la vidéo. Pour les personnages, assurez des proportions corporelles claires, l'absence d'occlusion et une couverture supérieure à 5% de la surface de l'image.

•requis video_url
Déposez un fichier, ou

URL pointant vers la vidéo dont les actions du personnage guident la sortie ; elle doit montrer un personnage de style réaliste et dégagé, avec la tête et soit le corps entier, soit le haut du corps visibles. Le paramètre character_orientation limite la durée à 10s pour 'image' ou 30s pour 'video'. Limites du fichier : 100 MB maximum, largeur et hauteur comprises entre 340px et 3850px, et durée comprise entre 3.0s et 30.05s.

character_orientation •requis

Source de l'orientation du personnage : 'image' correspond à l'image de référence et convient mieux au suivi des mouvements de caméra, avec un maximum de 10 secondes. Pour les mouvements complexes, 'video' est préférable : elle correspond à l'orientation de la vidéo de référence et autorise jusqu'à 30 secondes.

Avancé enable_safety_checker · keep_original_sound · elements

Association faciale facultative pour améliorer la préservation de l'identité dans la vidéo de sortie, limitée à 1 élément téléversé. Utilisez @Element1 pour le référencer dans le prompt. L'association est disponible uniquement avec character_orientation défini sur 'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 devis → 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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Kling Video · v3 · Pro · Motion Control

Combine une image de personnage dans `image_url` avec les mouvements d'une vidéo de référence dans `video_url`. `character_orientation` est requis et détermine si l'orientation suit l'image ou la vidéo. Un `prompt` facultatif de 2500 caractères maximum est pris en charge, `keep_original_sound` conserve l'audio de référence et un élément facial peut être associé via `elements` pour aider à préserver l'identité.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Les contrôles de sécurité peuvent être désactivés uniquement avec l'autorisation du compte ; les requêtes sans autorisation sont toujours contrôlées.
promptfacultatif
Typestring | null
≤ 2 500 caractères
image_urlrequis image
Typeurl · image
URL de l'image de référence pour la génération vidéo, avec une taille de fichier maximale de 10.0MB, une largeur et une hauteur comprises entre 340px et 3850px, et un rapport hauteur-largeur compris entre 0.40 et 2.50. Cette image guide les personnages, arrière-plans et autres éléments de la vidéo. Pour les personnages, assurez des proportions corporelles claires, l'absence d'occlusion et une couverture supérieure à 5% de la surface de l'image.
video_urlrequis video
Typeurl · video
URL pointant vers la vidéo dont les actions du personnage guident la sortie ; elle doit montrer un personnage de style réaliste et dégagé, avec la tête et soit le corps entier, soit le haut du corps visibles. Le paramètre character_orientation limite la durée à 10s pour 'image' ou 30s pour 'video'. Limites du fichier : 100 MB maximum, largeur et hauteur comprises entre 340px et 3850px, et durée comprise entre 3.0s et 30.05s.
keep_original_soundfacultatif
Typeboolean
Par défauttrue
Contrôle la conservation du son original de la vidéo de référence.
character_orientationrequis
Typeenum
imagevideo
Source de l'orientation du personnage : 'image' correspond à l'image de référence et convient mieux au suivi des mouvements de caméra, avec un maximum de 10 secondes. Pour les mouvements complexes, 'video' est préférable : elle correspond à l'orientation de la vidéo de référence et autorise jusqu'à 30 secondes.
elementsfacultatif
Typeobject[]
Association faciale facultative pour améliorer la préservation de l'identité dans la vidéo de sortie, limitée à 1 élément téléversé. Utilisez @Element1 pour le référencer dans le prompt. L'association est disponible uniquement avec character_orientation défini sur 'video'.
elements[].frontal_image_urlfacultatif
Typeurl · image
Image frontale montrant la vue principale de l'élément. La taille du fichier ne doit pas dépasser 50 MB ; la largeur et la hauteur doivent chacune mesurer au moins 300px, avec un rapport hauteur-largeur compris entre 0.40 et 2.50.
elements[].reference_image_urlsfacultatif
Typeurl[] · image
Fournissez 1–3 images de référence supplémentaires montrant différents angles. Chaque image doit avoir un rapport hauteur-largeur compris entre 0.40 et 2.50, mesurer au moins 300px dans les deux dimensions et ne pas dépasser 50.0MB.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Vidéo produite par le modèle.

Plus de modèles : Vidéo vers vidéo

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/kling-video/v3/pro/motion-control.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt