Skip to main content
POST
Interface grok-imagine-video-1.5-preview

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>[]
requis

URL de l'image de référence (ce modèle est en image vers vidéo, obligatoire)

Exigences :

  • Prend en charge uniquement 1 image
  • Taille de l'image : max 10MB
  • Formats pris en charge : JPEG, PNG, WebP
Required array length: 1 element
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

aspect_ratio
enum<string>
défaut:16:9

Rapport d'aspect

Options :

  • 16:9 : Paysage (par défaut)
  • 9:16 : Portrait
  • 1:1 : Carré
  • 4:3 : Paysage 4:3
  • 3:4 : Portrait 3:4
  • 3:2 : Paysage 3:2
  • 2:3 : Portrait 2:3
Options disponibles:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3
Exemple:

"16:9"

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