xAI

Grok Imagine 1.5

grok-imagine-1.5/image-to-video

Modèle de génération vidéo de xAI : la génération vidéo à partir d'image permet d'animer des images fixes avec génération audio synchronisée, avec prise en charge de 480p à 1080p et de clips allant jusqu'à 15 secondes

grok-imagine-1.5/image-to-video

Essayer grok-imagine-1.5/image-to-video

Entrée

Créations

Voir toutes les créations

Sortie

video

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

grok-imagine-1.5/image-to-video per second

Spécifications	Prix unitaire
480P	$0.0114
720P	$0.0214
1080P	$0.05714

Présentation

grok-imagine-1.5/image-to-video est un modèle image-vers-vidéo lancé par xAI, accessible via l'interface unifiée de HiAPI.ai. Il transforme une ou plusieurs images de référence en un court clip de 1 à 15 secondes, avec une sortie en 480p, 720p ou 1080p, et un prompt optionnel pour décrire le mouvement souhaité. En cas d'entrée multi-images, un paramètre de ratio d'aspect permet de contrôler la composition. Il s'adresse aux développeurs et équipes créatives qui souhaitent animer rapidement des photos produit, des images conceptuelles ou des assets de marque, pour la prévisualisation et la livraison de contenus courts.

Points clés

Composition dynamique à partir de plusieurs images de référence — jusqu'à 7 images de référence, avec un format de sortie unifié via aspect_ratio en entrée multi-images.
Durée et définition combinables à la demande — longueur réglable en continu de 1 à 15 secondes, résolution 480p, 720p ou 1080p, pour équilibrer qualité et coût selon l'usage.
Contrôle précis du mouvement par prompt — prompt optionnel jusqu'à 4096 caractères pour décrire les mouvements de caméra et de sujet souhaités.

Capacités

Génération vidéo pilotée par l'image : fournissez 1 à 7 images JPEG, PNG ou WebP avec un prompt optionnel pour générer un court clip animé, sans avoir à retourner les éléments statiques.

Sortie multi-résolutions : choisissez entre 480p, 720p et 1080p ; utilisez la basse résolution pour itérer rapidement en phase de brouillon, puis passez en 1080p pour la livraison finale.

Contrôle flexible de la durée : durée spécifiée en secondes entières, de 1 à 15 secondes ; la facturation augmente avec la durée de sortie, ce qui permet d'ajuster la longueur du clip au rythme du contenu.

Contrôle du ratio d'aspect en multi-images : six options de format — auto, 1:1, 16:9, 9:16, 3:2, 2:3 — pour uniformiser la composition avec plusieurs images de référence ; en entrée mono-image, le ratio suit l'image d'origine.

Cas d'usage

Animation de photos produit pour l'e-commerce et les équipes produit — à partir d'une image principale et d'une brève description de mouvement, produisez un clip de présentation de quelques secondes pour les pages détail, les supports publicitaires ou les contenus de recommandation sur les réseaux sociaux.
Validation de concept et brouillons publicitaires pour les équipes marketing — générez rapidement plusieurs aperçus animés en différentes durées et formats à partir d'images de concept de marque, pour une revue interne avant la production finale.
Création de vidéos verticales courtes pour les réseaux sociaux — générez un clip à partir d'une seule image créative et d'un prompt de mouvement, pour l'alimentation quotidienne des fils d'actualité et des plateformes de vidéos courtes.
Prévisualisation de storyboard pour les créatifs — transformez des illustrations clés ou des maquettes en courts clips, pour offrir une référence dynamique concrète lors des échanges client et des prévisualisations avant tournage.

Limites et conseils de sélection

Seul l'image-vers-vidéo est pris en charge : au moins une image de référence est requise, la génération à partir de texte seul n'est pas possible. La sortie est un clip court, limité à 15 secondes, inadapté à la narration longue. La 1080p n'accepte qu'une seule image d'entrée ; pour la composition multi-images, utilisez uniquement 480p ou 720p. En entrée mono-image, aspect_ratio est sans effet : le format est déterminé par l'image d'origine. Pour les projets exigeant des plans longs, une synchronisation labiale précise ou une narration complexe, évaluez d'abord si un assemblage de plusieurs segments peut répondre au besoin avant de choisir ce modèle.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveaux modèles : grok-imagine-1.5-lite/text-to-video et grok-imagine-1.5-l… Oct 16, 2026

Questions fréquentes

Voir toutes les questions →

Grok Imagine 1.5 Image to Video nécessite-t-il le téléchargement d'une image ?

Oui. Actuellement, grok-imagine-1.5/image-to-video est une voie de génération vidéo à partir d'image : l'image d'entrée définit le sujet et la composition initiale, tandis que le Prompt décrit les mouvements, les mouvements de caméra et les changements d'environnement.
Quelles durées et résolutions Grok Imagine 1.5 Image to Video prend-il en charge ?

Le contrat de requête actuel de HiAPI prend en charge 1–15s, avec des résolutions de sortie de 480p et 720p. Les valeurs disponibles sont celles du panneau de paramètres de la page et de la documentation API.
Comment est facturé Grok Imagine 1.5 Image to Video ?

Les tâches sont facturées en fonction de la durée de sortie et du niveau sélectionné. La page affiche le prix en temps réel selon l'unité monétaire globale ; la facturation finale se base sur l'enregistrement des tâches réussies.
Comment améliorer la stabilité du sujet dans la génération de vidéo à partir d'images ?

Utilisez une image d'entrée avec un sujet net, peu d'occlusions et une composition complète ; dans le Prompt, décrivez d'abord l'action principale et le cadrage, puis énumérez l'apparence, les matériaux et les relations avec l'arrière-plan à conserver. Pour le premier test, il est recommandé d'utiliser une durée plus courte.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : grok-imagine-1.5/image-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour grok-imagine-1.5/image-to-video et la route default — voir le tableau des paramètres ci-dessous.

promptstringOptionnelmaxLength 4096

Prompt textuel facultatif décrivant le mouvement d'image souhaité, jusqu'à 4096 caractères, l'anglais donnant les meilleurs résultats.

durationintegerOptionnelDéfaut: 8min 1max 15

Durée de la vidéo générée, en secondes, valeur entière comprise entre 1 et 15, 8 secondes par défaut ; le coût augmente avec la durée.

image_urlsarrayRequisminItems 1maxItems 7

Tableau d'images de référence, prenant en charge de 1 à 7 images, chacune au format JPEG, PNG ou WebP, ne dépassant pas 20 Mo, le format SVG n'étant pas pris en charge ; lorsque resolution vaut 1080p, une seule image est autorisée.

Array [ string ]

resolutionstringOptionnelDéfaut: "480p"

Résolution de la vidéo de sortie, 480p par défaut ; le coût par seconde est plus élevé en 720p, et maximal en 1080p, qui ne prend en charge qu'une seule image d'entrée.

Options：480p720p1080p

aspect_ratiostringOptionnelDéfaut: "auto"

Rapport largeur/hauteur de la vidéo de sortie, auto par défaut ; ce paramètre n'a aucun effet lorsqu'une seule image d'entrée est fournie, la sortie suivant alors le rapport largeur/hauteur de l'image d'entrée ; il ne s'applique que lorsqu'il y a plusieurs images de référence.

Options：auto1:116:99:163:22:3

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "duration": 8,
    "image_urls": "…",
    "resolution": "480p",
    "aspect_ratio": "auto"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-1.5/image-to-video",
    input: {
      "duration": 8,
      "image_urls": "…",
      "resolution": "480p",
      "aspect_ratio": "auto"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-1.5/image-to-video",
        "input": {
          "duration": 8,
          "image_urls": "…",
          "resolution": "480p",
          "aspect_ratio": "auto"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}