88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Image

API des modèles d’image Grok

Interfaces texte vers image et édition d’image, formats d’image, résolutions, images de référence et erreurs des modèles d’image Grok Imagine (grok-imagine-image, 2.0, quality, edit).

Champ d’application

Cette page présente les modèles d’image Grok Imagine. Pour les modèles vidéo, consultez API vidéo Grok.

Choix de l’interface

Les modèles d’image Grok utilisent les interfaces compatibles OpenAI Images :

UsageMéthodePoint de terminaison
Texte vers imagePOST/v1/images/generations
Édition d’image (image vers image)POST/v1/images/edits

/v1/chat/completions et /v1/responses ne sont pas pris en charge. Les images de référence ne peuvent être transmises que via /v1/images/edits ; celles placées dans /v1/images/generations sont ignorées.

Modèles et capacités

ModèleRésolutionImages de référenceImages par requêteFacturation
grok-imagine-image1K (par défaut) / 2K
aspect_ratio + resolution
jusqu’à 3 (data URI / URL publique / fichier local)jusqu’à 10par image
grok-imagine-image-2.01K (par défaut) / 2K
aspect_ratio + resolution
jusqu’à 3 (data URI / URL publique / fichier local)jusqu’à 10par image
grok-imagine-image-quality1K (par défaut) / 2K
aspect_ratio + resolution
jusqu’à 3 (data URI / URL publique / fichier local)jusqu’à 10par image
grok-imagine-edit
Identique à grok-imagine-image-quality
1K (par défaut) / 2K
aspect_ratio + resolution
jusqu’à 3 (data URI / URL publique / fichier local)jusqu’à 10par image

Formats pris en charge : auto (par défaut) / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 2:1 / 1:2 / 19.5:9 / 9:19.5 / 20:9 / 9:20 / 21:9 / 5:2

Modèlequalityresponse_format
grok-imagine-imageNon pris en chargeb64_json / url
grok-imagine-image-2.0low / medium / autob64_json / url
grok-imagine-image-qualityNon pris en chargeb64_json / url
grok-imagine-editNon pris en chargeb64_json / url
  • Les quatre modèles prennent tous en charge le texte vers image et l’édition d’image.
  • grok-imagine-edit et grok-imagine-image-quality sont le même modèle et produisent le même résultat.
  • Le paramètre quality ne s’applique qu’à grok-imagine-image-2.0.
  • La facturation se fait au nombre d’images renvoyées avec succès, quels que soient la résolution et le nombre d’images de référence.

Les modèles réellement disponibles sont ceux de la liste de modèles renvoyée par la console.

Authentification

Authorization: Bearer $API_KEY
Content-Type: application/json

Format d’image et résolution

  • aspect_ratio : voir le tableau des capacités ci-dessus. La valeur par défaut est auto : le modèle choisit le cadrage en fonction du prompt, et un même prompt ne donne donc pas toujours le même format. Si vous avez besoin d’une taille fixe, indiquez-la explicitement.
  • resolution : 1k (par défaut) ou 2k ; la 4K n’est pas prise en charge.

Pixels de sortie pour chaque niveau (identiques pour les quatre modèles) :

Format1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • La sortie 1K est en JPEG et la sortie 2K en PNG ; ce choix ne peut pas être modifié avec output_format.
  • Vous pouvez aussi utiliser size à la manière d’OpenAI (par exemple 1024x1024), qui est converti automatiquement : un grand côté inférieur ou égal à 1024 donne 1k, au-delà 2k, et le format le plus proche parmi ceux pris en charge est retenu. Les pixels renvoyés ne correspondent donc pas forcément au size demandé. 1536x1024 et 1792x1024 sont tous deux générés en 2k.
  • Si vous transmettez à la fois size et aspect_ratio / resolution, ce sont aspect_ratio / resolution qui s’appliquent.

Texte vers image

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "Une rue de Tokyo sous les néons par une nuit de pluie, ambiance cinématographique, photographie réaliste",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

Paramètres de la requête

ParamètreTypeObligatoireDescription
modelstringOuiNom du modèle.
promptstringOuiDescription de l’image, ne doit pas être vide. Nous recommandons de ne pas dépasser quelques milliers de caractères.
aspect_ratiostringNonFormat d’image, auto par défaut.
resolutionstringNon1k (par défaut) ou 2k.
nintegerNonNombre d’images, de 1 à 10, 1 par défaut.
response_formatstringNonb64_json (par défaut) ou url. Avec url, un lien d’image 88API est renvoyé.
qualitystringNongrok-imagine-image-2.0 uniquement : low, medium, auto (par défaut ; low pour la génération, medium pour l’édition). medium est plus lent à générer.

Les paramètres style, seed, negative_prompt, background, output_format, stream, etc. sont ignorés.

Exemple de réponse

{
  "created": 1760000000,
  "data": [
    { "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
  ]
}

La réponse ne contient pas de revised_prompt.

Édition d’image

Requête JSON (recommandée, plusieurs images de référence possibles)

Utilisez image pour une seule image de référence et le tableau images pour plusieurs, jusqu’à 3 :

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Placer la personne de la première image dans la scène de la deuxième image, en conservant son apparence",
    "images": [
      "data:image/png;base64,...",
      "https://example.com/scene.jpg"
    ],
    "resolution": "2k"
  }'
  • Les images de référence peuvent être des Data URI ou des URL publiques directement téléchargeables. Les données Base64 doivent comporter le préfixe data:image/...;base64,.
  • Les formats JPG, PNG et WebP sont pris en charge, mais pas GIF ni BMP.
  • Ne transmettez pas image sous forme de tableau, et ne transmettez pas image et images en même temps.
  • Les images de référence sont numérotées dans l’ordre de transmission ; dans le prompt, vous pouvez y faire référence par « la première image », « la deuxième image », etc.
  • Sans format d’image indiqué, la sortie reprend le format de la première image de référence, avec une résolution 1k par défaut ; vous pouvez les remplacer avec aspect_ratio et resolution.

Envoi multipart (une seule image)

Les fichiers locaux peuvent aussi être envoyés en multipart, mais une seule image par requête, et 20 Mo maximum par fichier :

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=grok-imagine-image" \
  -F "image=@input.png" \
  -F "prompt=Remplacer l’arrière-plan par un coucher de soleil en bord de mer" \
  -F "aspect_ratio=1:1"

Pour plusieurs images de référence, utilisez une requête JSON.

Limitations

  • La retouche locale par mask n’est pas prise en charge ; un masque transmis est ignoré.
  • Le streaming et la récupération asynchrone des résultats ne sont pas pris en charge.
  • Les images générées portent des Content Credentials C2PA (indiquant une génération par IA), sans filigrane visible.

Erreurs courantes

SituationHTTPMessage renvoyé
Appel de l’interface de chat ou Responses400<模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits (<modèle> est un modèle d’image et ne prend pas en charge l’interface <interface> ; utilisez les interfaces d’image)
Format d’image non pris en charge400不支持的图片比例。支持:… (format d’image non pris en charge, suivi des valeurs acceptées)
Résolution non prise en charge (par exemple 4k)400不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 (résolution non prise en charge ; seules les valeurs en minuscules 1k ou 2k sont acceptées)
n hors de la plage 1 à 10, prompt vide, image et images transmis ensemble, plusieurs images en multipart400上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 (le service en amont a refusé les paramètres ; vérifiez le nom du modèle, l’interface appelée et les paramètres)
Format d’image de référence non pris en charge, préfixe Base64 manquant, URL impossible à télécharger400Message d’erreur relatif à l’image de référence
Plus de 3 images de référence502Upstream request failed
Échec de la modération du contenu400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 (l’image n’a pas passé le contrôle de sécurité du contenu ; modifiez le prompt ou les éléments de référence puis réessayez)

Les requêtes en échec ci-dessus ne sont pas facturées.