API Kling Motion Control : faire copier une vidéo par un personnage

Ce que fait le contrôle du mouvement

Kling Motion Control prend deux éléments : l'image d'un personnage et la vidéo d'une personne en mouvement. Il produit un nouveau clip dans lequel le personnage de l'image exécute le mouvement de la vidéo, avec le même rythme, les mêmes gestes et le même langage corporel. C'est ce qui permet de réaliser des tendances de danse, des vidéos de mascottes et des porte-parole de produits qui bougent comme un vrai acteur, sans filmer le personnage lui-même.

Revana propose deux versions :

Kling 3.0 est le modèle le plus récent. Kling 2.6 coûte environ moitié moins en 720p : il vaut donc la peine d'être testé d'abord sur vos images.

Quoi envoyer

• image_url : le personnage, idéalement en pied, face à la caméra, sur un fond uni. C'est lui qui apparaît dans le résultat.
• video_url : le clip de mouvement. Une seule personne, bien visible, avec une caméra stable, donne les meilleurs résultats. Le résultat suit sa durée.
• resolution : 720p ou 1080p. Envoyez-le à chaque fois.
• prompt : facultatif, pour décrire le décor ou des détails absents de l'image.

Les deux fichiers doivent être des liens que l'API peut récupérer. Pour envoyer un fichier depuis votre ordinateur, téléversez-le d'abord avec POST /v1/uploads (clips jusqu'à 50 Mo) et utilisez le lien renvoyé ; il reste valable 14 jours.

Comment le contrôle du mouvement est facturé (octobre 2026)

Le prix est à la seconde de vidéo, et la durée est définie par votre clip de mouvement, arrondie à la seconde entière supérieure. Un clip de danse de 7,4 secondes est facturé comme 8 secondes.

Découpez le clip de mouvement pour ne garder que la partie dont vous avez besoin avant de l'envoyer : chaque seconde supplémentaire est facturée. Définissez max_cost_usd sur le maximum que vous comptez payer pour la durée de votre clip, et une tâche qui coûterait plus cher est refusée au lieu d'être exécutée. Une tâche en échec ne coûte rien, et le crédit est prépayé à partir de $10 sans abonnement ; voir la page des tarifs.

Créer un clip avec contrôle du mouvement

Envoyez POST /v1/generations avec les deux liens, puis interrogez jusqu'à ce que la tâche soit succeeded ou failed. Avec un clip de mouvement de 10 secondes en 720p, cela coûte $1.30.

export REVANA_API_KEY="sr_live_..."

# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-motion-control",
    "input": {
      "prompt": "The mascot dances on a sunny rooftop, city skyline behind.",
      "image_url": "https://example.com/mascot-full-body.png",
      "video_url": "https://example.com/dance-10s.mp4",
      "resolution": "720p"
    },
    "max_cost_usd": 1.6
  }'

# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
  -H "Authorization: Bearer $REVANA_API_KEY"

import os
import time

import requests

API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}

resp = requests.post(f"{API}/generations", headers=HEADERS, json={
    "model": "kling-3.0-motion-control",
    "input": {
        "prompt": "The mascot dances on a sunny rooftop, city skyline behind.",
        "image_url": "https://example.com/mascot-full-body.png",
        "video_url": "https://example.com/dance-10s.mp4",
        "resolution": "720p",
    },
    "max_cost_usd": 1.6,
})
resp.raise_for_status()
job = resp.json()

while job["status"] in ("queued", "running"):
    time.sleep(5)
    job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()

if job["status"] == "succeeded":
    print(job["output"]["urls"], job["cost_usd"])
else:
    print("Failed:", job["error"])

// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
  Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
  "Content-Type": "application/json",
};

const res = await fetch(`${API}/generations`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "kling-3.0-motion-control",
    input: {
      prompt: "The mascot dances on a sunny rooftop, city skyline behind.",
      image_url: "https://example.com/mascot-full-body.png",
      video_url: "https://example.com/dance-10s.mp4",
      resolution: "720p",
    },
    max_cost_usd: 1.6,
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 5000));
  job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}

if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);

{
  "id": "gen_01JC2V8K5T",
  "model": "kling-3.0-motion-control",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC2V8K5T/0.mp4"
    ],
    "duration_s": 10
  },
  "cost_usd": 1.3,
  "attempts": 1,
  "error": null,
  "created_at": "2026-10-28T10:14:02Z",
  "completed_at": "2026-10-28T10:15:31Z"
}

Obtenir un résultat propre

• Accordez les cadrages. Un personnage en pied avec un clip de danse en pied fonctionne bien mieux qu'un portrait tête et épaules avec un clip en pied.
• Une seule personne qui bouge. Utilisez un clip où une seule personne bouge. Les foules et les coupes brouillent le mouvement à copier.
• Caméra stable. Une caméra fixe ou à déplacement lent garde l'arrière-plan stable.
• Faites des brouillons en 720p. Vérifiez le transfert du mouvement sur Kling 2.6 en 720p, puis rendez la version retenue en 1080p sur Kling 3.0.

Pour les modèles de texte vers vidéo et d'image vers vidéo de Kling, voir le guide de l'API Kling 3.0. Les deux modèles de contrôle du mouvement sont sur la page des modèles, avec chaque champ dans la documentation. Obtenez une clé API pour les essayer.