model: kling-v3-motion. Fournissez des références d'apparence et de mouvement, soumettez une requête asynchrone et suivez le img_uuid renvoyé par interrogation ou rappel.API de contrôle de mouvement Kling V3 pour la vidéo de personnage guidée par référence
Accédez au contrôle de mouvement Kling V3 via GoEnhance avec
Obtenir une clé API
Combiner les références d'apparence et de mouvement dans une seule requête
Définir l'apparence du personnage
Utilisez image_url pour une image claire du personnage en buste ou en pied, ou utilisez au plus un élément Kling via element_ids. L'entrée d'élément force character_orientation: video.
Transférer le mouvement depuis une vidéo de référence
Fournissez un fichier MP4 ou MOV requis dans video_url. La sortie suit le mouvement continu utilisable de ce fichier ; ce point de terminaison n'a pas de paramètre duration.
Validez les médias avant la soumission ; les valeurs de durée ou de résolution non prises en charge doivent être rejetées côté client.
Capacités et règles de validation de l'API de contrôle de mouvement Kling V3
Point de terminaison et modèle
POST vers <code>https://api.goenhance.ai/api/v1/videos/generations</code> avec <code>model: kling-v3-motion</code>.
Invite
Envoyez une <code>prompt</code> requise allant jusqu'à 2 500 caractères pour décrire le personnage, les vêtements, la scène ou la direction de génération pertinente.
Entrée d'apparence
Une <code>image_url</code> peut être au format JPG, JPEG ou PNG, jusqu'à 50 Mo, au moins 300 px par côté, avec un rapport hauteur/largeur de 1:2,5 à 2,5:1.
Entrée de mouvement
La <code>video_url</code> requise doit être au format MP4 ou MOV, ne dépassant pas 100 Mo, avec des dimensions allant de 340 à 3 850 px.
Orientation et durée
<code>character_orientation: video</code> accepte 3 à 30 secondes ; <code>image</code> accepte 3 à 10 secondes. La valeur par défaut documentée est <code>video</code>.
Résolution et audio
Choisissez 720p ou 1080p ; il n'y a pas de niveau 4K. <code>generate_audio</code> conserve le son original de la vidéo de mouvement et est défini sur false par défaut.
La tarification s'effectue par seconde générée, tandis que GoEnhance mesure la longueur de la vidéo de mouvement en entrée comme limite supérieure de facturation de la requête.
Tarification de l'API Kling V3 Motion Control
Tarif 720p
6,3 jetons par seconde générée, équivalent à $0.126/s au tarif documenté de $0.02 par jeton.
Tarif 1080p
8,4 jetons par seconde générée, équivalent à $0.168/s au tarif documenté de $0.02 par jeton.
Estimation des coûts
Estimez le coût maximal de la requête en multipliant la durée mesurée de la vidéo de mouvement par le tarif exact de la résolution sélectionnée.
Facturation basée sur l'entrée mesurée
GoEnhance transfère et mesure <code>video_url</code> avant de déduire des jetons ; par conséquent, modifier le fichier distant après la mesure ne change pas le montant facturé pour l'entrée.
La sortie peut être plus courte
Kling extrait un mouvement continu utilisable, donc un mouvement difficile ou très rapide peut produire une sortie plus courte que la vidéo de référence.
Aucun paramètre de durée
N'envoyez pas <code>duration</code> ; le point de terminaison le rejette et la longueur de la sortie suit le mouvement utilisable extrait de la vidéo de référence.
Intégrer Kling V3 Motion Control en six étapes
1
1. Créer une clé API
Créez une clé API GoEnhance et envoyez-la dans l'en-tête
Authorization. 2
2. Valider les deux références
Vérifiez la clarté et les dimensions de l'image, puis validez le format, la taille, les dimensions et la longueur dépendante de l'orientation de la vidéo de mouvement.
3
3. Soumettre et conserver la tâche
Envoyez la requête via POST avec
model: kling-v3-motion, puis enregistrez le img_uuid renvoyé avant de confier le travail à un processeur d'arrière-plan. 4
4. Suivre le statut
Interrogez
GET /api/v1/jobs/detail ou fournissez une custom_callback_url HTTPS accessible publiquement. 5
5. Gérer les rappels de manière idempotente
Traitez les événements de statut répétés en toute sécurité. Un rappel qui ne renvoie pas HTTP 200 peut être relancé jusqu'à trois fois avec un délai d'attente de trois secondes par tentative.
6
6. Stocker le résultat final
Séparez le traitement, la réussite et la gestion des échecs, et enregistrez l'URL finale de la vidéo uniquement une fois que la tâche atteint un état final.
Utilisez des médias que vous êtes autorisé à traiter et concevez pour un achèvement asynchrone.
Cas d'utilisation pour les développeurs de Kling V3 Motion Control
Clips de performance de personnage
Appliquez des références de mouvement approuvées à une apparence de personnage cohérente pour des pipelines de vidéos narratives ou promotionnelles courtes.
Aperçus de danse et de chorégraphie
Transférez des mouvements de répétition sous licence dans des aperçus dirigés par des personnages tout en préservant le consentement et les droits sur l'audio source.
Concepts d'animation de personnage de jeu
Générez des études de mouvement à partir d'art de personnage et de mouvements enregistrés avant de vous engager dans un flux de travail d'animation complet.
Variantes de campagne localisées
Paramétrez les invites et les entrées d'apparence pour des variantes créatives régionales tout en réutilisant une couche d'orchestration de tâches.
Flux de travail d'interprète virtuel
Construisez des pipelines d'interprètes contrôlés autour de références d'images, d'actifs de mouvement et de paramètres d'orientation approuvés.
Prévisualisation
Testez si une référence de mouvement est adaptée à un personnage avant le montage, la composition et la révision en aval.
Réponses aux questions courantes sur l'intégration, la tarification, la validation et l'API Kuaishou.