curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-custom-element",
  "model_params": {
    "element_name": "Mon personnage",
    "element_description": "Un jeune personnage masculin aux cheveux courts, portant un T-shirt blanc",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/front.jpg",
      "refer_images": [
        {
          "image_url": "https://example.com/side.jpg"
        }
      ]
    }
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-8dxnm6yz",
  "model": "kling-custom-element",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 600
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "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-custom-element",
    "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"
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream AI service unavailable",
    "type": "upstream_error"
  }
}

Kling

Kling Élément personnalisé

Kling Custom Element (kling-custom-element) crée des éléments de sujet réutilisables (personnages/objets) à partir d’images ou de vidéos de référence
Après une création réussie, l’element_id retourné peut être référencé dans la série Kling O3 et Kling V3 Image-vers-Vidéo via le paramètre element_list, permettant un contrôle cohérent de l’apparence des personnages
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour interroger le statut
À l’achèvement de la tâche, result_data contiendra l’element_id pour la génération vidéo

Notes importantes :

Ce modèle est utilisé pour créer des sujets réutilisables (éléments), il ne génère pas de vidéos, aucun paramètre prompt / duration / quality / aspect_ratio n’est nécessaire

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-custom-element",
  "model_params": {
    "element_name": "Mon personnage",
    "element_description": "Un jeune personnage masculin aux cheveux courts, portant un T-shirt blanc",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/front.jpg",
      "refer_images": [
        {
          "image_url": "https://example.com/side.jpg"
        }
      ]
    }
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-8dxnm6yz",
  "model": "kling-custom-element",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 600
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "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-custom-element",
    "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"
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream AI service unavailable",
    "type": "upstream_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-custom-element

requis

Nom du modèle

Options disponibles:

kling-custom-element

Exemple:

"kling-custom-element"

model_params

object

requis

Paramètres du modèle

Show child attributes

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 création d'élément de sujet soumise avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1757169743

string

ID de tâche

Exemple:

"task-unified-1757169743-8dxnm6yz"

model

string

Nom du modèle réellement utilisé

Exemple:

"kling-custom-element"

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

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

video

Exemple:

"video"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Seedance 2.0 Mini Reference-to-Video Kling-O3 Texte vers Vidéo

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Kling Élément personnalisé

Autorisations

Toutes les API nécessitent une authentification Bearer Token

Corps

Réponse