Grok Imagine Video 1.5

Grok Imagine Video 1.5 est le modèle vidéo de xAI. Une seule requête crée un clip de 6 à 15 secondes avec son à partir d'un prompt, ou d'un prompt et d'une image, en 480p ou 720p, au format 16:9, 9:16 ou 1:1. Envoyez la requête, conservez l'identifiant de tâche renvoyé et récupérez la vidéo terminée dans la tâche. Les images sont transmises sous forme d'URL.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Point de terminaison

POST https://api.seedrouter.ai/v1/videos/generations

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas la vidéo terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Gardez les clés API dans le code côté serveur.

Paramètres

Le schéma est strict : les champs inconnus sont rejetés au lieu d'être ignorés. callback_url n'est pas disponible ; interrogez plutôt la tâche.

Image vers vidéo

Passez une image dans image_urls et décrivez ce qui se passe ensuite dans prompt. Le clip s'ouvre sur l'image et en prend le format : une image en portrait donne donc un clip en portrait, quelle que soit la valeur de aspect_ratio.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

Entrées média

L'image est une URL HTTP(S) publique. Les data URI en base64 ne sont pas acceptées : téléversez le fichier sur votre propre stockage et transmettez son URL. Utilisez une image JPG ou PNG de 10 Mo maximum.

Facteurs de coût

Consultez la section tarifs du modèle pour les tarifs actuels. Grok Imagine Video 1.5 est facturé à la seconde de vidéo, à un tarif fixé par la résolution :

cost = duration × rate per second for the resolution

Le texte vers vidéo et l'image vers vidéo coûtent le même prix. La durée est connue à l'acceptation de la requête, si bien que le montant réservé est le montant facturé. Consultez les frais définitifs dans l'historique d'utilisation de votre compte. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L'envoi renvoie la tâche :

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

Récupérer la tâche

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interrogez toutes les 10 à 20 secondes jusqu'à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l'interrogation ne signifie pas que la génération a échoué : conservez l'identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l'avancement.

Tâche terminée

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Lors de nos tests, des clips 720p de 8 secondes sont revenus au format MP4 (H.264) avec une piste audio AAC en 1280 × 720 pour 16:9, 720 × 1280 pour 9:16 et 720 × 720 pour 1:1, 111 à 133 secondes après l'envoi. Les clips 480p sont revenus en 45 à 84 secondes.

Erreurs

Les requêtes rejetées avant la création d'une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu'on l'interroge, avec status: "failed" et un objet error.

Voir le catalogue d'erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si l'envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Décrivez le sujet, le lieu, le mouvement de caméra et la lumière, et précisez les sons souhaités ; le son est généré en même temps que l'image.
• Faites un brouillon en 480p, puis générez le plan final en 720p avec la même requête.
• Pour une vidéo verticale, envoyez aspect_ratio: "9:16" ou une image en portrait.
• Ajoutez no text, no logos pour éviter les marques inventées.

Ressources liées

• Playground et tarifs de Grok Imagine Video 1.5
• Référence de l'API Kling 3.0 Turbo
• Télécharger l'OpenAPI
• Markdown copiable