Skip to main content
POST
Ce point de terminaison est asynchrone. Une soumission réussie renvoie un ID de tâche. Interrogez l’état de la tâche pour obtenir le résultat final. Sans image_urls, il s’agit de text-to-image ; avec des références, d’édition ou de référence multi-image.

Capacités du modèle

Body

string
défaut:"grok-imagine-image-2.0"
requis
Valeur fixe : grok-imagine-image-2.0.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Instruction de génération ou d’édition. Non vide après suppression des espaces, 8 000 caractères maximum.
integer
défaut:"1"
Nombre de sorties : 110.
string
défaut:"auto"
Valeurs : 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto.
string
défaut:"1k"
1k ou 2k.
string
Text-to-image uniquement : low ou medium par défaut. Ne pas envoyer avec image_urls.
array
Une à trois références. Seules les URL HTTP(S) absolues et publiquement accessibles sont acceptées. Téléversez d’abord les images locales avec POST /v1/uploads/images, puis utilisez l’url renvoyée.

Tâche asynchrone

La soumission réussie renvoie HTTP 202 et l’ID de tâche dans data.id. Utilisez data.poll_url ou GET /v1/tasks/{task_id} jusqu’à completed ou failed.