curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v4-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-text-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-text-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 Texte vers Vidéo
- Kling-4.0 Text to Video (kling-v4-text-to-video) génère des vidéos à partir de texte
- 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
/
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-v4-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-text-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-text-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
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
Nom du modèle de génération vidéo
Options disponibles:
kling-v4-text-to-video Exemple:
"kling-v4-text-to-video"
Prompt textuel décrivant la vidéo à générer
Remarque :
- Maximum
2500caractères
Maximum string length:
2500Exemple:
"A cat running on a grassy field under bright sunshine"
Durée de la vidéo en secondes. Valeur par défaut : 5 secondes
Plage :
- Entier de
3à30
Plage requise:
3 <= x <= 30Exemple:
5
Rapport d’aspect de la vidéo
Options :
16:9: Paysage9:16: Portrait1:1: Carré21:9: Ultra-large
Options disponibles:
16:9, 9:16, 1:1, 21:9 Exemple:
"16:9"
Niveau de résolution
Options :
720p: Standard 720P1080p: Haute qualité 1080P
Options disponibles:
720p, 1080p Exemple:
"720p"
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
2048caractères
Mécanisme de rappel :
- Délai d'expiration :
10secondes - Maximum
3tentatives après échec (à1/2/4secondes 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
Horodatage de création de la tâche
Exemple:
1757169743
ID de tâche
Exemple:
"task-unified-1757169743-7cvnl5zw"
Nom du modèle réellement utilisé
Exemple:
"kling-v4-text-to-video"
Type de tâche
Options disponibles:
video.generation.task Pourcentage de progression de la tâche (0-100)
Plage requise:
0 <= x <= 100Exemple:
0
Statut de la tâche
Options disponibles:
pending, processing, completed, failed Exemple:
"pending"
Détails de la tâche vidéo
Show child attributes
Show child attributes
Type de sortie de la tâche
Options disponibles:
text, image, audio, video Exemple:
"video"
Informations d'utilisation et de facturation
Show child attributes
Show child attributes