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 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.
Obtenir une clé API
Production cinématographique avec référence de mouvement pour l'API de contrôle de mouvement Kling V3

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.
Photographie contrôlée par référence d'apparence pour la génération de vidéos de personnages

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.
Répétition de chorégraphie en scène unique utilisée comme référence de mouvement
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 https://api.goenhance.ai/api/v1/videos/generations avec model: kling-v3-motion.

Invite

Envoyez une prompt 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 image_url 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 video_url 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

character_orientation: video accepte 3 à 30 secondes ; image accepte 3 à 10 secondes. La valeur par défaut documentée est video.

Résolution et audio

Choisissez 720p ou 1080p ; il n'y a pas de niveau 4K. generate_audio 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 video_url 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 duration ; 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.
Obtenir une clé API
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.

FAQ de l'API de contrôle de mouvement Kling V3

Quel est le point de terminaison de l'API Kling V3 Motion Control ?

Soumettez via GoEnhance à POST https://api.goenhance.ai/api/v1/videos/generations avec model: kling-v3-motion. La réponse renvoie un img_uuid.

Comment fonctionne la tarification de l'API Kling V3 Motion Control ?

Le 720p coûte 6,3 jetons/s ($0.126/s) et le 1080p coûte 8,4 jetons/s ($0.168/s). GoEnhance mesure la durée de la vidéo de mouvement avant déduction comme limite supérieure de facturation de la requête.

Puis-je envoyer un paramètre de durée ?

Non. Ce point de terminaison rejette duration. La vidéo de référence doit respecter les limites spécifiques à l'orientation, et la sortie suit le mouvement continu utilisable extrait de celle-ci.

Que modifie character_orientation ?

video suit la direction de l'orientation dans la vidéo de mouvement et autorise 3 à 30 secondes. image suit l'image d'apparence et autorise 3 à 10 secondes.

L'API peut-elle générer de l'audio natif ?

Non. generate_audio conserve uniquement la bande sonore originale de la vidéo de mouvement. Il est désactivé par défaut ; utilisez l'audio uniquement si vous disposez des droits nécessaires.

Puis-je utiliser un élément Kling au lieu d'une image ?

La route V3 accepte au plus une valeur via element_ids (ou l'alias à valeur unique element_id). L'entrée d'élément impose character_orientation: video.

Comment fonctionnent les rappels (callbacks) ?

Fournissez une custom_callback_url HTTPS publique. Le corps du rappel correspond à la réponse des détails du travail ; les livraisons non-200 peuvent être réessayées jusqu'à trois fois avec un délai d'attente de trois secondes.

S'agit-il de l'API officielle de Kuaishou ?

Non. Kling est associé à Kuaishou, mais cette page décrit un accès indépendant via GoEnhance. GoEnhance n'est pas présenté comme l'API officielle, un partenaire ou un développeur de modèle de Kuaishou ou de Kling.

Développez avec l'API de contrôle de mouvement Kling V3