Skip to main content
POST
Cet endpoint accepte aussi l’alias grok-imagine-1.5-ext, équivalent à grok-imagine-1.5-apimart et interchangeable.

Authorizations

string
requis
Toutes les API nécessitent une authentification Bearer TokenObtenir une API Key :Visitez la page de gestion des API KeyAjoutez-la dans l’en-tête de la requête :

Body

string
défaut:"grok-imagine-1.5-apimart"
requis
Nom du modèle de génération d’imagesModèles pris en charge :
  • grok-imagine-1.5-apimart - génération et édition d’images Grok (alias grok-imagine-1.5-ext)
Exemple :"grok-imagine-1.5-ext"
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
Description textuelle pour la génération ou l’édition d’image
string[]
Liste d’URL d’images de référence. Omettre pour le text-to-image ; inclure pour l’édition.
  • Ce modèle prend en charge de 1 à 5 images de référence
  • Accepte uniquement les URL absolues publiques http:// ou https://
  • Téléversez d’abord les images locales avec POST /v1/uploads/images, puis utilisez l’url renvoyée
string
défaut:"1:1"
Taille de l’image de sortieFormats pris en charge :
  • 1:1 - Carré (par défaut)
  • 16:9 - Paysage large
  • 9:16 - Portrait
  • 3:2 - Paysage
  • 2:3 - Portrait
integer
défaut:1
Nombre d’images à générerPlage : 1-10 (minimum 1, maximum 10)⚠️ Remarque : doit être un nombre brut (ex. 1), sans guillemets, sinon erreur

Response

integer
Code d’état de la réponse
array
Tableau de données de réponse

Cas d’usage

Cas 1 : Text-to-Image

Cas 2 : Text-to-Image (taille et nombre)

Cas 3 : Édition d’image (arrière-plan)

Cas 4 : Édition d’image (style)

Modèles officiels

grok-imagine-image et grok-imagine-image-quality utilisent le même flux de tâches asynchrones que les autres modèles d’image. Après l’envoi, utilisez l’ID de tâche renvoyé et interrogez l’état de la tâche jusqu’à la fin ou l’échec.
N’envoyez pas quality. Sans image_urls, le modèle génère depuis le texte ; une image active l’édition, plusieurs images servent de références multiples.

Paramètres de requête

Valeurs aspect_ratio : 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.

Réponse de création de tâche

202
Utilisez data.id ou data.poll_url jusqu’à ce que l’état devienne completed ou failed.