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-preview",
  "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-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "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-preview",
    "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 Vidéo Preview

Le modèle Grok Imagine 1.5 (grok-imagine-video-1.5-preview) prend en charge le texte vers vidéo, l’image vers vidéo et la référence 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), 2-7 = référence vers vidéo
Mode de traitement asynchrone, utiliser l’ID de tâche retourné pour interroger
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": "grok-imagine-video-1.5-preview",
  "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-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "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-preview",
    "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-preview

requis

Nom du modèle

Options disponibles:

grok-imagine-video-1.5-preview

Exemple:

"grok-imagine-video-1.5-preview"

prompt

string

requis

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

Limite de longueur : max 4096 caractères

Exemple:

"The person starts dancing"

image_urls

string<uri>[]

URL des images d'entrée (facultatif). Le nombre d'images sélectionne le mode de génération.

Sélection du mode :

0 image (champ omis) : texte vers vidéo, aucun frais d'image
1 image : image vers vidéo, utilisée comme première image
2-7 images : référence vers vidéo, fusionnées ensemble

Exigences :

Jusqu'à 7 images ; 8 ou plus sont refusées
Taille de l'image : max 10MB chacune
Formats pris en charge : JPEG, PNG, WebP

Maximum array length: 7

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 : Full HD

La génération à partir de références (2 à 7 images) prend en charge jusqu'à 720p. Envoyer 1080p avec 2 images ou plus est rejeté. 1080p reste disponible pour le texte vers vidéo et l'image vers vidéo à une seule image.

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) et référence vers vidéo (2-7 images). Avec une seule image d'entrée, la sortie suit les dimensions de cette image et ce paramètre est ignoré.

Description :

auto : Le modèle décide du cadrage, qui peut varier d'une génération à l'autre ; valeur par défaut
16:9 : Paysage
9:16 : Portrait
1:1 : Carré
3:2 : Paysage, format photo classique
2:3 : Portrait, format photo classique

Options disponibles:

auto,

16:9,

9:16,

1:1,

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
Envoyé après confirmation de la facturation

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 caractères

Mécanisme de rappel :

Délai d'expiration : 10 secondes
Maximum 3 tentatives en cas d'échec (après 1/2/4 secondes)
Le format de réponse correspond à 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-preview"

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 Vidéo Preview

Autorisations

Corps

Réponse