Passer au contenu principal
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-o1-image-to-video",
  "prompt": "A cat walking gracefully",
  "image_urls": [
    "https://example.com/first-frame.jpg"
  ]
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-o1-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 7,
    "user_group": "default"
  }
}

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-o1-image-to-video
requis

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

Options disponibles:
kling-o1-image-to-video
Exemple:

"kling-o1-image-to-video"

​
prompt
string
requis

Invite décrivant quelle vidéo générer

Maximum string length: 5000
Exemple:

"A cat walking gracefully"

​
image_urls
string<uri>[]
requis

Liste d'URL d'images de référence pour la génération image vers vidéo

Remarque :

  • Prend en charge 1 à 2 images par requête (1 image pour la génération vidéo première image, 2 images pour la génération vidéo première et dernière image)
  • Taille d'image : jusqu'à 10MB
  • Formats pris en charge : .jpg, .jpeg, .png, .webp
  • L'URL de l'image doit être directement accessible par le serveur, ou l'URL doit déclencher un téléchargement direct lors de l'accès (généralement les URL se terminant par des extensions d'image comme .png, .jpg)
Required array length: 1 - 2 elements
Exemple:
["https://example.com/image1.jpg"]
​
aspect_ratio
enum<string>

Rapport d'aspect vidéo

Options :

  • 16:9 : Vidéo paysage
  • 9:16 : Vidéo portrait
  • 1:1 : Vidéo carrée
Options disponibles:
16:9,
9:16,
1:1
Exemple:

"16:9"

​
duration
enum<integer>
défaut:5

Durée de la vidéo en secondes, par défaut 5 secondes

Remarque :

  • Prend en charge uniquement les valeurs 5 ou 10, représentant 5 secondes ou 10 secondes
  • La facturation est basée sur la valeur duration, une durée plus longue coûte plus cher
Options disponibles:
5,
10
Exemple:

5

​
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

​
id
string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"kling-o1-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

​
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