curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video-1.5-lite",
  "prompt": "Une rue éclairée au néon la nuit, lent travelling avant sous la pluie",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-lite",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 6
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 5.712,
    "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: grok-imagine-video-1.5-lite",
    "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"
  }
}

Grok

Grok Imagine 1.5 Lite Vidéo

Grok Imagine 1.5 Lite (grok-imagine-video-1.5-lite) est le niveau moins cher de Grok Imagine 1.5 : texte vers vidéo et image vers vidéo sous un seul nom de modèle
Il n’y a pas de paramètre de mode : le nombre d’entrées dans image_urls sélectionne le mode — 0 = texte vers vidéo, 1 = image vers vidéo (utilisée comme première image). Les images de référence (2 ou plus) ne sont pas prises en charge
La sortie 1080p est agrandie depuis le 720p et facturée à un tarif par seconde plus élevé
Mode de traitement asynchrone, utilisez l’ID de tâche renvoyé pour interroger
Les liens vidéo générés sont valables 24 heures, veuillez les enregistrer 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": "grok-imagine-video-1.5-lite",
  "prompt": "Une rue éclairée au néon la nuit, lent travelling avant sous la pluie",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-lite",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 6
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 5.712,
    "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: grok-imagine-video-1.5-lite",
    "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:grok-imagine-video-1.5-lite

requis

Nom du modèle

Options disponibles:

grok-imagine-video-1.5-lite

Exemple:

"grok-imagine-video-1.5-lite"

prompt

string

requis

Prompt de description vidéo (obligatoire, ne peut pas être vide)

Limite de longueur de la plateforme EvoLink: max 2000 tokens (comptés avec le tokenizer cl100k ; un texte CJK atteint la limite avec bien moins de caractères qu'un texte latin). La plateforme applique aussi une limite de 60000 octets UTF-8.

Exemple:

"The person starts dancing"

image_urls

string<uri>[]

URL de l'image d'entrée (facultatif). Une image fait passer la requête en image vers vidéo.

Sélection du mode :

0 image (omettre le champ) : texte vers vidéo, pas de frais d'image
1 image : image vers vidéo, utilisée comme première image ; les images d’entrée sont facturées séparément (voir la section tarifs)
2 images ou plus sont rejetées — la référence vers vidéo n'est pas prise en charge sur Lite

Exigences :

Imports locaux du Playground : jusqu’à 10MiB (10485760 octets) par image. Les URL d’images envoyées directement à l’API sont validées par le fournisseur, sans ce contrôle d’import local.
Formats pris en charge : JPEG, PNG, WebP

Maximum array length: 1

Exemple:

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

duration

integer

défaut:6

Durée de la vidéo (secondes), nombre entier quelconque entre 1 et 15 secondes

Plage requise: 1 <= x <= 15

Exemple:

6

quality

enum<string>

défaut:480p

Résolution de la vidéo, 480p par défaut

Description :

480p : Définition standard, valeur par défaut
720p : Haute définition
1080p : Agrandi depuis le 720p, facturé à un tarif par seconde plus élevé

Consultez la section tarifs pour les tarifs par résolution.

Options disponibles:

480p,

720p,

1080p

Exemple:

"480p"

aspect_ratio

enum<string>

défaut:auto

Format d'image de sortie, auto par défaut

S'applique à : texte vers vidéo (0 image). Avec une image d'entrée, la sortie suit les dimensions de cette image et ce paramètre est ignoré.

Description :

auto : Aucun format n'est envoyé en amont, le canal amont décide du cadrage (le texte vers vidéo produit actuellement du 16:9) ; valeur par défaut
16:9 : Paysage
9:16 : Portrait
1:1 : Carré
4:3 : Paysage, format TV classique
3:4 : Portrait, format TV classique
3:2 : Paysage, format photo classique
2:3 : Portrait, format photo classique

Options disponibles:

auto,

16:9,

9:16,

1:1,

4:3,

3:4,

3:2,

2:3

Exemple:

"16:9"

callback_url

string<uri>

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

Moment du rappel :

Déclenché lorsque la tâche est terminée, échouée ou annulée

Restrictions de sécurité :

Seul le protocole HTTPS est pris en charge
Rappel vers les IP internes interdit (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 octets UTF-8

Mécanisme de rappel :

Délai d'expiration : 10 secondes
Maximum 3 tentatives en cas d'échec (après 1/2/4 secondes)
Le corps de la requête de rappel utilise la structure de réponse de l’API d’interrogation de tâche
Code de statut 2xx = succès, les autres déclenchent une nouvelle tentative

Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tâche 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:

"grok-imagine-video-1.5-lite"

object

enum<string>

Type de tâche spécifique

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

Informations détaillées 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

Grok Imagine 1.5 Lite Vidéo

Autorisations

Corps

Réponse