Grok Imagine video
Les modèles prennent en charge le texte, une première image et des images de référence. Les vidéos de référence, l'audio de référence et les paires première/dernière image sont exclus. Une première image et une référence ordinaire n'ont pas le même sens : leur nombre ne suffit pas à choisir le mode.
Modèles et caractéristiques
| Modèle | Durée de sortie | Résolution | Images de référence |
|---|---|---|---|
grok-imagine-video | 1–15 secondes | 480p / 720p | Jusqu'à 7 images actuellement, 10 secondes maximum |
grok-imagine-video-1.5 | 1–15 secondes | 480p / 720p / 1080p | Jusqu'à 7 images actuellement, préréglage limité à 15 secondes |
Respectez les limites de chaque mode. « ≥7 » dans la documentation signifie que des essais acceptaient au moins sept images, pas qu'il faut en envoyer sept, ni qu'un maximum strict a été publié. PopGo autorise actuellement 1–7 images de référence.
Champs et modes
| Champ | Type | Règle |
|---|---|---|
model | string | Identifiant public requis, indiqué ci-dessus |
prompt | string | Requis ; 4096 octets UTF-8 maximum |
seconds | integer | Entier selon le mode ; 8 secondes par défaut dans l'interface |
resolution | string | Selon le modèle ; 720p par défaut dans l'interface |
aspect_ratio | string | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 ; 16:9 par défaut ; omettre pour la première image |
input_reference | object | Exactement une première image ; objet contenant image_url |
reference_images | object[] | Références de sujet/style ; tableau d'objets contenant image_url |
La première image démarre la scène ; les références guident le sujet, le style et la cohérence. Une seule image peut rester une référence ordinaire. input_reference et reference_images s'excluent. N'utilisez pas image_url à la racine : un champ incorrect peut être ignoré alors que la génération et la facturation continuent.
Sources, proportions et prompt
Le service décrit les URL publiques et les Data URL complètes, mais signale aussi des téléchargements d'images publiques échouant après création. Le préréglage Grok actuel encode en Base64 : les fichiers locaux deviennent des valeurs data:image/...;base64,... complètes. Les images publiques doivent être lues puis encodées ; les restrictions interorigines du navigateur peuvent empêcher cette étape. Base64 brut, chemins locaux et pages de partage ne conviennent pas.
Le mode première image omet aspect_ratio. Le service suit l'image et peut la recadrer ou la redimensionner : recadrez d'abord pour une composition précise. Les références ordinaires acceptent un ratio. Aucune garantie exhaustive ne couvre toutes les proportions d'entrée.
4096 est une limite d'octets, pas de caractères. Les essais documentés avec 1365 caractères chinois occupaient 4095 octets et passaient ; 1366 caractères occupaient 4098 octets et échouaient. Mesurez la longueur UTF-8 des textes mixtes et raccourcissez le prompt.
Exemples
Ces exemples montrent la première image et les références ordinaires. Remplacez YOUR_IMAGE_DATA_URL par une Data URL complète. Pour le texte seul, retirez tous les champs de référence.
{
"model": "YOUR_MODEL",
"prompt": "A person turns naturally toward the camera",
"seconds": 5,
"resolution": "720p",
"input_reference": { "image_url": "YOUR_IMAGE_DATA_URL" }
}
{
"model": "YOUR_MODEL",
"prompt": "Keep the subject and visual style consistent",
"seconds": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_images": [{ "image_url": "YOUR_IMAGE_DATA_URL" }]
}
Champs inconnus et audio de sortie
HTTP 200 ne prouve pas l'effet de seed, watermark ou d'autres champs non documentés. N'ajoutez pas de paramètre absent du préréglage courant. generate_audio contrôle uniquement la piste de sortie, pas un audio de référence. Un champ inconnu ne contourne pas les limites de durée ou d'exclusion.
Erreurs et corrections
| Erreur ou symptôme | Action |
|---|---|
| reference-to-video duration exceeds 10s | Limitez à 10 secondes le mode référence du modèle standard |
| Prompt length exceeds 4096 | Réduisez la longueur en octets UTF-8 |
| Duration must be between 1 and 15 seconds | Utilisez un entier et la limite plus stricte du mode |
| Cannot specify both image and reference_images | Gardez une seule représentation, première image ou références |
| grok_media_no_eligible_account | Capacité indisponible ; reprises limitées et espacées, sans créations parallèles |
| imagine:content-moderated | Révisez le contenu ; certains cas documentés avaient une consommation non nulle, consultez la facturation PopGo |
| Succès sans effet de référence | Inspectez les champs envoyés, le téléchargement et les images finales ; un ID ne prouve pas l'utilisation |
Conservez id et interrogez queued / in_progress / completed / failed. Vérifiez la tâche existante avant toute nouvelle création : un délai dépassé ne prouve pas l'échec. Distinguez permissions, solde et capacité. Voir le Cycle des tâches vidéo pour requêtes, téléchargements, coûts et reprises.