curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

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

Kling-4.0 Image vers Vidéo

Kling-4.0 Image to Video (kling-v4-image-to-video) génère des vidéos à partir d’images
Prend en charge une première et une dernière image, ainsi que des images intermédiaires entre elles
Le rapport d’aspect est déterminé par l’image de première trame, aspect_ratio n’est pas accepté
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

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-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

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

requis

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

Options disponibles:

kling-v4-image-to-video

Exemple:

"kling-v4-image-to-video"

image_start

string<uri>

requis

URL de l'image de première trame pour la génération image-vers-vidéo (requis)

Remarque :

Taille de l'image : jusqu'à 10 Mo
Formats pris en charge : .jpg, .jpeg, .png
Dimensions de l'image : largeur et hauteur >= 300px, rapport d'aspect entre 1:2.5 et 2.5:1
L'URL de l'image doit être directement accessible par le serveur ou déclencher un téléchargement direct lors de l'accès

Exemple:

"https://example.com/portrait.jpg"

prompt

string

requis

Prompt textuel décrivant la vidéo à générer

Remarque :

Maximum 2500 caractères

Maximum string length: 2500

Exemple:

"The person in the image slowly turns their head and smiles"

image_end

string<uri>

URL de l'image de dernière trame

Remarque :

image_start (première trame) doit être fourni lors de l'utilisation de la dernière trame
Formats pris en charge : .jpg, .jpeg, .png
Taille de l'image : jusqu'à 10 Mo
L'URL de l'image doit être directement accessible par le serveur ou déclencher un téléchargement direct lors de l'accès

Exemple:

"https://example.com/night.jpg"

keyframes

object[]

Images intermédiaires, réparties uniformément dans l’ordre indiqué entre la première et la dernière image

Remarque :

Nombre : de 1 à 8 images
Le total des images initiale, intermédiaires et finale ne doit dépasser ni 10 images ni duration + 1 (par exemple, au maximum 4 images pour 3 secondes ou 6 images pour 5 secondes)
La dernière image est facultative. Si elle est omise, le modèle génère l’image de fin
Taille de l'image : jusqu'à 10 Mo
Formats pris en charge : .jpg, .jpeg, .png
Dimensions de l'image : largeur et hauteur >= 300px, rapport d'aspect entre 1:2.5 et 2.5:1
L'URL de l'image doit être directement accessible par le serveur ou déclencher un téléchargement direct lors de l'accès

Maximum array length: 8

Show child attributes

Exemple:

[
  {
    "image_url": "https://example.com/half-open.jpg"
  },
  {
    "image_url": "https://example.com/open.jpg"
  }
]

duration

integer

défaut:5

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

Plage :

Entier de 3 à 30

Plage requise: 3 <= x <= 30

Exemple:

5

quality

enum<string>

défaut:720p

Niveau de résolution

Options :

720p : Standard 720P
1080p : Haute qualité 1080P

Options disponibles:

720p,

1080p

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-image-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 Image vers Vidéo

Autorisations

Toutes les API nécessitent une authentification Bearer Token

Corps

Réponse