Guide d'utilisation
API de redessin de style vidéo Kling Transformation : unifier le style visuel de chaque vidéo courte
Avec kling-3.0-omni/transformation, remodelez vos séquences existantes dans un style de vidéo courte unifié — deux vidéos sources sans rapport, un même préréglage de prompt, tous deux intégrés ici sous forme de sorties réelles.
Si vous publiez des vidéos courtes, votre pire ennemi n'est pas le manque d'idées — c'est la cohérence visuelle. Vous tournez ou générez des séquences à des moments, sous des éclairages et depuis des sources différents, et résultat : votre fil ressemble au travail de cinq créateurs distincts. La solution habituelle consiste à passer des heures dans un logiciel de montage à étalonner manuellement et à harmoniser les filtres.
kling-3.0-omni/transformation propose une autre voie : donnez-lui une vidéo existante et un prompt, et il redessine l'image entière — scène, palette, texture, sujet — tout en préservant intégralement le mouvement de caméra et le timing d'origine. Ce dernier point est essentiel. Il ne régénère pas votre vidéo, il lui applique une nouvelle peau. Cela signifie que vous pouvez prendre un lot de séquences sans rapport, les faire toutes passer par un même prompt, et imposer ainsi un style visuel unique et unifié.
Cet article est le complément « production de vidéos courtes » de notre guide d'utilisation de l'API transformation. Ce guide détaille le flux brut create → poll → download ; le présent article se concentre sur le workflow qui compte vraiment pour les créateurs : unifier une série de séquences sous un même style visuel et redessiner tout un lot en batch avec un seul script. Chaque vidéo ci-dessous est une vraie sortie de /v1/tasks, accompagnée de son prompt exact et de son coût.
L'astuce clé : un « préréglage visuel » réutilisable
Voici une vidéo redessinée dans un style aquarelle de livre d'images peint à la main. La source est une scène nocturne morne et plate d'un bateau en papier dans un caniveau urbain — la version ci-dessous est le résultat renvoyé par le modèle :
Tout le redessin est piloté par le prompt — ce point de terminaison n'a pas de curseur strength ni fidelity. L'écart entre la sortie et la source dépend de la force de votre texte. C'est une caractéristique, pas une limite : cela signifie que votre prompt est le préréglage. Écrivez-le une fois, sauvegardez la chaîne exacte, puis réutilisez-la mot pour mot sur chaque séquence que vous voulez harmoniser.
Voici le prompt qui a produit la vidéo ci-dessus, prêt à copier-coller :
Restyle this video as a hand-painted watercolor storybook illustration:
soft visible brushstroke textures, a warm golden-amber and muted teal
palette, gentle paper grain, softly glowing highlights, and a cozy
picture-book mood. Keep the exact camera motion, framing, timing, and
subject movement from the source clip completely unchanged — change only
the visual style, never the action.
Remarquez les deux moitiés. La première moitié est le style visuel : palette, texture, ambiance — la partie que vous mettriez dans une charte graphique de marque. La seconde moitié est l'instruction impérative de conserver le mouvement et le timing. Retirez la seconde moitié et vous glissez vers la régénération ; conservez-la et vous obtenez un changement de peau fidèle. Pour une série de vidéos courtes, cette séparation est exactement ce que vous voulez : le style visuel se transmet d'une séquence à l'autre, tandis que le mouvement reste natif à chaque plan.
La preuve : un préréglage, deux séquences sans rapport
Un préréglage de style n'est utile que s'il fonctionne encore sur des images pour lesquelles il n'a pas été conçu. Voici donc deux séquences sources totalement différentes, redessinées avec exactement la même chaîne de prompt que ci-dessus — rien d'autre n'a changé entre les deux exécutions que la vidéo d'entrée.
Séquence A — avant redessin : un bateau en papier dérive dans un caniveau urbain éclairé par des néons, la nuit.
Séquence B — avant redessin : à l'aube, des bateaux de pêche en bois amarrés dans un port brumeux. Sujet différent, moment de la journée différent, palette différente, rythme de caméra différent.
Voyez maintenant le résultat redessiné de la séquence B avec le même préréglage :
Placez les deux sorties redessinées côte à côte : elles se lisent comme un ensemble cohérent — mêmes tons ambre et bleu-vert, mêmes bords texturés de papier, même douceur de livre d'images — alors que l'une provient d'une nuit urbaine froide et l'autre d'un matin marin brumeux. C'est cela, l'unification de style : des images sans rapport, un style visuel identifiable. Et dans les deux sorties, le mouvement d'origine est intact — le bateau en papier dérive toujours sur le même trajet, et le plan du port effectue toujours le même panoramique.
Redessiner toute une bibliothèque : traitement par lots asynchrone
Toute vraie production de vidéos courtes à volume signifie des dizaines ou des centaines de séquences, pas deux. Vous ne voulez pas les redessiner une par une avec des appels bloquants. L'API de tâches est asynchrone, donc le bon schéma est : soumettre tous les segments d'un coup, puis récupérer les résultats à mesure qu'ils se terminent.
Le schéma est minimal — seulement trois champs dans input : prompt, video_urls (exactement une URL source publique) et resolution (720p, 1080p ou 4k). Voici un lanceur de batch compact qui applique le même préréglage à un ensemble de séquences :
import os, time, json, requests
API = "https://api.hiapi.ai/v1/tasks"
TOKEN = os.environ["HIAPI_API_KEY"]
HEADERS = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}
PRESET = (
"Restyle this video as a hand-painted watercolor storybook illustration: "
"soft visible brushstroke textures, a warm golden-amber and muted teal palette, "
"gentle paper grain, softly glowing highlights, and a cozy picture-book mood. "
"Keep the exact camera motion, framing, timing, and subject movement from the "
"source clip completely unchanged — change only the visual style, never the action."
)
# Your clip library — the SAME preset is applied to every one of them.
SOURCE_CLIPS = [
"https://example.com/clips/hook-01.mp4",
"https://example.com/clips/hook-02.mp4",
# ...dozens more
]
def submit(video_url: str) -> str:
body = {
"model": "kling-3.0-omni/transformation",
"input": {"prompt": PRESET, "video_urls": [video_url], "resolution": "720p"},
}
r = requests.post(API, headers=HEADERS, json=body, timeout=60)
return r.json()["data"]["taskId"]
# 1) Fire off every task first — they run in parallel on the platform.
tasks = {submit(url): url for url in SOURCE_CLIPS}
print(f"submitted {len(tasks)} restyle tasks")
# 2) Poll until each one reaches a terminal state, then grab the output URL.
pending = set(tasks)
outputs = {}
while pending:
for task_id in list(pending):
r = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=40)
data = r.json().get("data", {})
status = data.get("status")
if status == "success":
outputs[task_id] = data["output"][0]["url"]
pending.discard(task_id)
elif status == "fail":
print(f"{task_id} failed: {data.get('error')}")
pending.discard(task_id)
if pending:
time.sleep(8)
# 3) Download immediately — output URLs are short-lived signed links.
for task_id, url in outputs.items():
dest = f"restyled-{task_id}.mp4"
with open(dest, "wb") as f:
f.write(requests.get(url, timeout=120).content)
print("saved", dest)
Deux points méritent d'être soulignés, tous deux approfondis dans le guide d'utilisation : téléchargez immédiatement les sorties (les URL renvoyées expirent) et, pour les gros lots, privilégiez un callback au lieu d'interroger frénétiquement, afin de ne pas marteler sans cesse le point de terminaison de détail. La documentation des tâches asynchrones décrit la structure des requêtes et réponses.
Conseils pratiques pour la vidéo courte
- Gardez les séquences sources courtes. Le coût est calculé à la seconde, donc un court accrocheur est à la fois moins cher et plus rapide. Les deux séquences de 3 secondes ci-dessus coûtent environ 0,43 $ chacune en 720p (tarification ci-dessous).
- Choisissez la résolution pour la plateforme, pas pour votre vanité. En octobre 2026,
kling-3.0-omni/transformationest facturé 0,143 $ par seconde en 720p, 0,193 $ par seconde en 1080p et 0,479 $ par seconde en 4K. Pour un fil vertical qui sera de toute façon recompressé, 720p–1080p est généralement la zone idéale ; le 4K est pour les pièces maîtresses. Vérifiez toujours les chiffres actuels sur la page de tarification. - Verrouillez le préréglage, puis n'y touchez plus. Dès que vous peaufinez la formulation pour chaque séquence, vous perdez la cohérence qui justifiait le redessin. Versionnez votre chaîne de préréglage comme du code.
- Le mouvement est hérité, pas créé. La durée et le mouvement de la sortie suivent la séquence source. Si vous avez besoin que le modèle crée du mouvement à partir d'un prompt ou d'une image fixe, c'est un autre outil — voir texte-vers-vidéo ou image-vers-vidéo.
FAQ
Puis-je contrôler l'intensité du redessin ? Pas via un paramètre — il n'y a aucun champ strength ou fidelity. Le contrôle passe par la formulation. Pour un léger étalonnage, décrivez un changement subtil de couleur/texture et insistez sur « conserve le reste tel quel » ; pour un redessin complet comme l'exemple aquarelle, empilez le vocabulaire stylistique. L'intensité du redessin réside entièrement dans votre prompt.
Conserve-t-il mon mouvement d'origine ou réanime-t-il la scène ? Il conserve le mouvement et le timing de la source — c'est le comportement définissant le point de terminaison transformation. La clause explicite « conserve exactement le mouvement de caméra et le timing » renforce ce point. La durée de la sortie correspond à la séquence d'entrée.
En quoi cela diffère-t-il de l'image-vers-vidéo ou de la référence-vers-vidéo ? L'image-vers-vidéo anime une image fixe en mouvement ; la référence-vers-vidéo emprunte des éléments à un média de référence pour les intégrer à une séquence nouvellement générée. Transformation part d'une vidéo finie et n'en change que le style, en conservant le mouvement que vous avez déjà. Pour les autres modes, voir les recettes de prompt référence-vers-vidéo.
Quelle résolution et quelle longueur de source fonctionnent le mieux pour la vidéo courte ? Des sources propres et bien éclairées — le modèle redessine ce qu'il voit, donc une source floue donne un redessin flou. Gardez les accroches et les plans de coupe (B-roll) de quelques secondes ; traitez par lots beaucoup de séquences courtes plutôt qu'une seule longue, à la fois pour le coût et pour le parallélisme par séquence illustré ci-dessus.
Puis-je utiliser un seul préréglage sur toute la série ?
Oui — c'est tout l'intérêt. Réutilisez exactement la même chaîne de prompt sur chaque séquence, et elles partageront le même style visuel. Le script de traitement par lots ci-dessus fait exactement cela : une constante PRESET, appliquée à chaque élément source de la liste.
Donnez à votre fil un style visuel unifié
Si vos vidéos courtes semblent provenir de comptes différents, kling-3.0-omni/transformation est le moyen le plus rapide de les unifier : écrivez un préréglage visuel, appliquez-le à tout, et conservez le mouvement natif de chaque séquence. Prenez un extrait, copiez le préréglage aquarelle ci-dessus (ou écrivez le vôtre), puis exécutez-le sur la page du modèle kling-3.0-omni/transformation. Quand vous serez prêt à écrire votre script de batch, le guide d'utilisation contient le client complet.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Guide de démarrage pour seedream-5.0-pro/image-to-image : capacités, tarification et points d'intégration
Limites de capacité, mode de facturation et pratiques d'intégration technique du modèle d'édition d'image de ByteDance
-
Guide d'utilisation
Guide de prise en main de la génération d'images par texte avec seedream-5.0-pro : limites de capacités, intégration API et maîtrise des coûts
Point de vue pratique pour les développeurs : des points clés des paramètres à l'estimation du coût de 0,05 $ par image
-
Guide d'utilisation
Guide de prise en main de Hailuo 2.3 Fast image-to-video : limites de capacités, tarification et intégration pratique
Points clés pour les développeurs : choisir et intégrer le modèle image-to-video de MiniMax