Skip to main content
POST

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 :

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:
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
Options disponibles:
480p,
720p,
1080p
Exemple:

"480p"

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

id
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

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