curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2.6-motion-control",
"prompt": "A girl dancing gracefully",
"image_urls": [
"https://example.com/character.jpg"
],
"video_urls": [
"https://example.com/dance-reference.mp4"
],
"quality": "720p",
"model_params": {
"character_orientation": "image"
}
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v2.6-motion-control",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 300,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 22.68,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: kling-v2.6-motion-control",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Kling-V2.6
Kling 2.6 Contrôle de mouvement
- Kling 2.6 Motion Control (kling-v2.6-motion-control) prend en charge la génération de mouvement pilotée par image de référence + vidéo de référence
- Le système extrait la trajectoire de mouvement de la vidéo de référence et l’applique au personnage/objet de l’image de référence, générant une nouvelle vidéo avec des mouvements cohérents avec la vidéo de référence
- La durée de la vidéo dépend de
character_orientation:imagemax. 10 secondes,videomax. 30 secondes, minimum 3 secondes - Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour effectuer une requête
- Le lien de la vidéo générée est valide pendant 24 heures, veuillez le sauvegarder rapidement
- Facturation : à la seconde de vidéo générée, arrondie à la seconde entière la plus proche ;
1080pest facturé 1,6× le tarif720p - Les éléments de sujet (
element_list) ne sont pas pris en charge ; les requêtes avec unelement_listnon vide sont rejetées (une liste vide est ignorée). Utilisezkling-v3-motion-controlpour les éléments de sujet
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2.6-motion-control",
"prompt": "A girl dancing gracefully",
"image_urls": [
"https://example.com/character.jpg"
],
"video_urls": [
"https://example.com/dance-reference.mp4"
],
"quality": "720p",
"model_params": {
"character_orientation": "image"
}
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v2.6-motion-control",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 300,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 22.68,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: kling-v2.6-motion-control",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Autorisations
Toutes les interfaces nécessitent une authentification par Bearer Token
Obtenir une clé API :
Visitez la page de gestion des clés API pour obtenir votre clé API
Ajoutez dans l'en-tête de la requête :
Authorization: Bearer YOUR_API_KEY
Corps
application/json
Tableau d'URLs d'images de référence, utilisé pour fournir l'apparence du personnage/objet
Remarques :
- Fournir une image de référence
- Taille de l'image : ne dépassant pas
10 Mo - Formats de fichiers pris en charge :
.jpg,.jpeg,.png - Dimensions de l'image : largeur et hauteur ≥
300px, rapport largeur/hauteur entre1:2.5et2.5:1 - L'URL de l'image doit être directement accessible par le serveur
Exemple:
["https://example.com/character.jpg"]
Tableau d'URL de vidéos de référence pour fournir la trajectoire de mouvement
Note :
- Fournir une vidéo de référence
- Durée de la vidéo :
3à30secondes - Formats pris en charge :
.mp4,.mov - Taille de la vidéo : jusqu'à
100MB - Dimensions de la vidéo : largeur et hauteur entre
340pxet3850px - Éviter les coupes, les mouvements rapides et les changements de scène
- L'URL de la vidéo doit être directement accessible par le serveur
Exemple:
["https://example.com/dance-reference.mp4"]
Adresse de rappel HTTPS après l'achèvement de la tâche
Déclenchement du rappel :
- Déclenché lorsque la tâche est terminée (completed), échouée (failed) ou annulée (cancelled)
- Envoyé après la confirmation de la facturation
Restrictions de sécurité :
- Seul le protocole HTTPS est pris en charge
- Le rappel vers les adresses IP internes est interdit
- La longueur de l'URL ne doit pas dépasser
2048caractères
Mécanisme de rappel :
- Délai d'expiration :
10secondes - Jusqu'à
3nouvelles tentatives après un échec (avec des délais de1/2/4secondes après chaque échec) - Le format du corps de la réponse de rappel est identique à celui retourné par l'interface de requête de tâche
- Un code de statut 2xx de l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative
Exemple:
"https://your-domain.com/webhooks/video-task-completed"
Réponse
Tâche de génération vidéo créée avec succès