curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-flash-reference-to-video",
  "prompt": "Conserver le style de mouvement de <<<video_1>>> et remplacer le fond par un paysage enneigé",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "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-v4-flash-reference-to-video",
    "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-4.0-Flash

Kling-4.0-Flash Références vers Vidéo

Kling-4.0 Flash Reference to Video (kling-v4-flash-reference-to-video) génère de nouvelles vidéos à partir d’images et de vidéos de référence
Les vidéos servent de références de caractéristiques (sans édition directe) et peuvent être combinées avec du texte et des images de référence
Seule la résolution 720p est prise en charge, pour une durée de 3 à 20 secondes
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour consulter le statut
Les liens vidéo générés sont valides pendant 24 heures, veuillez les sauvegarder rapidement

Choisir entre Flash et Kling 4.0

Flash est conçu pour la création fréquente et les itérations créatives rapides, avec un accent sur la vitesse de génération et la maîtrise des coûts pour de courtes vidéos en 720p. La comparaison ci-dessous présente les fonctionnalités actuellement prises en charge par l’API EvoLink.

Caractéristique	Kling 4.0 Flash	Kling 4.0
Résolution de sortie	`720p`	`720p`, `1080p`
Durée de sortie	`3` à `20` secondes	`3` à `30` secondes
Images de référence	Jusqu’à `10`	Jusqu’à `10`
Vidéos de référence	Jusqu’à `5` clips, pour un total de `20` secondes maximum	Jusqu’à `5` clips, pour un total de `30` secondes maximum

La durée totale des vidéos de référence et la durée de sortie ont des limites distinctes. Réduire la durée de sortie n’augmente pas la limite d’entrée. Pour des références plus longues, une sortie en 1080p ou une durée de sortie supérieure à 20 secondes, utilisez Kling 4.0 Référence vers vidéo.

Flash utilise des identifiants de modèle distincts. Lors de la migration, vérifiez model, quality et duration. Les frais réels dépendent du tarif en vigueur du modèle Flash choisi et de la facturation finale de la tâche.

POST

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-v4-flash-reference-to-video",
  "prompt": "Conserver le style de mouvement de <<<video_1>>> et remplacer le fond par un paysage enneigé",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "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-v4-flash-reference-to-video",
    "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

Authorization

string

header

requis

Toutes les API nécessitent une authentification Bearer Token

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

défaut:kling-v4-flash-reference-to-video

requis

Nom du modèle de génération vidéo

Options disponibles:

kling-v4-flash-reference-to-video

Exemple:

"kling-v4-flash-reference-to-video"

prompt

string

requis

Prompt textuel de 2500 caractères maximum

Syntaxe de référence : Utilisez <<<xxx>>> dans le prompt pour référencer des images et des vidéos, par exemple : La personne de <<<image_1>>> marche dans la rue avec les mouvements de caméra de <<<video_1>>>

Maximum string length: 2500

Exemple:

"La personne de <<<image_1>>> marche dans la rue avec les mouvements de caméra de <<<video_1>>>"

video_urls

string<uri>[]

Tableau d’URL de vidéos de référence, jusqu’à 5 clips, correspondant dans l’ordre à <<<video_1>>>, <<<video_2>>>, etc. dans le prompt

Exigences vidéo :

Formats : MP4 / MOV
Taille : ≤ 200MB par clip
Durée : ≥ 3 secondes par clip, ≤ 20 secondes au total
Dimensions : largeur et hauteur de 720px à 2160px
Fréquence d’images : de 24fps à 60fps
Les URL des vidéos doivent être directement accessibles par le serveur

Maximum array length: 5

Exemple:

["https://example.com/reference.mp4"]

image_urls

string<uri>[]

Tableau d’URL d’images de référence (style, scène ou sujet), correspondant dans l’ordre à <<<image_1>>>, <<<image_2>>>, etc. dans le prompt

Limite : Jusqu’à 10 images Remarque : Les URL doivent être directement accessibles par le serveur ou déclencher un téléchargement direct lors de l’accès

Maximum array length: 10

Exemple:

["https://example.com/character.jpg"]

duration

integer

défaut:5

Durée de la vidéo en secondes. Valeur par défaut : 5 secondes

Plage :

Entier de 3 à 20

Plage requise: 3 <= x <= 20

Exemple:

5

aspect_ratio

enum<string>

défaut:16:9

Rapport d’aspect de la vidéo

Options :

16:9 : Paysage
9:16 : Portrait
1:1 : Carré
21:9 : Ultra-large

Options disponibles:

16:9,

9:16,

1:1,

21:9

Exemple:

"16:9"

quality

enum<string>

défaut:720p

Niveau de résolution

Options :

Seule la résolution 720p est prise en charge

Options disponibles:

720p

Exemple:

"720p"

callback_url

string<uri>

URL de rappel HTTPS pour l'achèvement de la tâche

Moment du rappel :

Déclenché lorsque la tâche est terminée, échouée ou annulée
Envoyé après confirmation de la facturation

Restrictions de sécurité :

Protocole HTTPS uniquement
Les adresses IP internes sont interdites (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

Délai d'expiration : 10 secondes
Maximum 3 tentatives après échec (à 1/2/4 secondes après l'échec)
Le format de réponse du rappel est cohérent avec l'API de requête de tâche
Un code de statut 2xx est considéré comme un succès, les autres codes 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

created

integer

Horodatage de création de la tâche

Exemple:

1757169743

string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

model

string

Nom du modèle réellement utilisé

Exemple:

"kling-v4-flash-reference-to-video"

object

enum<string>

Type de tâche

Options disponibles:

video.generation.task

progress

integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tâche

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"pending"

task_info

object

Détails de la tâche vidéo

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

text,

image,

audio,

video

Exemple:

"video"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Kling-4.0-Flash Références vers Vidéo

Choisir entre Flash et Kling 4.0

Autorisations

Toutes les API nécessitent une authentification Bearer Token

Corps

Réponse