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 :
| Usage | Méthode | Point de terminaison |
|---|---|---|
| Texte vers image | POST | /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èle | Résolution | Images de référence | Images par requête | Facturation |
|---|---|---|---|---|
grok-imagine-image | 1K (par défaut) / 2Kaspect_ratio + resolution | jusqu’à 3 (data URI / URL publique / fichier local) | jusqu’à 10 | par image |
grok-imagine-image-2.0 | 1K (par défaut) / 2Kaspect_ratio + resolution | jusqu’à 3 (data URI / URL publique / fichier local) | jusqu’à 10 | par image |
grok-imagine-image-quality | 1K (par défaut) / 2Kaspect_ratio + resolution | jusqu’à 3 (data URI / URL publique / fichier local) | jusqu’à 10 | par image |
grok-imagine-editIdentique à grok-imagine-image-quality | 1K (par défaut) / 2Kaspect_ratio + resolution | jusqu’à 3 (data URI / URL publique / fichier local) | jusqu’à 10 | par 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èle | quality | response_format |
|---|---|---|
grok-imagine-image | Non pris en charge | b64_json / url |
grok-imagine-image-2.0 | low / medium / auto | b64_json / url |
grok-imagine-image-quality | Non pris en charge | b64_json / url |
grok-imagine-edit | Non pris en charge | b64_json / url |
- Les quatre modèles prennent tous en charge le texte vers image et l’édition d’image.
grok-imagine-editetgrok-imagine-image-qualitysont le même modèle et produisent le même résultat.- Le paramètre
qualityne 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/jsonFormat d’image et résolution
aspect_ratio: voir le tableau des capacités ci-dessus. La valeur par défaut estauto: 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) ou2k; la 4K n’est pas prise en charge.
Pixels de sortie pour chaque niveau (identiques pour les quatre modèles) :
| Format | 1K | 2K |
|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 |
| 16:9 | 1280x720 | 2816x1584 |
| 9:16 | 720x1280 | 1584x2816 |
| 4:3 | 1152x864 | 2368x1776 |
| 3:4 | 864x1152 | 1776x2368 |
| 3:2 | 1248x832 | 2496x1664 |
| 2:3 | 832x1248 | 1664x2496 |
| 2:1 | 1408x704 | 2912x1456 |
| 1:2 | 704x1408 | 1456x2912 |
| 19.5:9 | 1248x576 | 2912x1344 |
| 9:19.5 | 576x1248 | 1344x2912 |
| 20:9 | 1280x576 | 3200x1440 |
| 9:20 | 576x1280 | 1440x3200 |
| 21:9 | 1568x672 | 3136x1344 |
| 5:2 | 1600x640 | 3200x1280 |
- 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 exemple1024x1024), qui est converti automatiquement : un grand côté inférieur ou égal à 1024 donne1k, 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 ausizedemandé.1536x1024et1792x1024sont tous deux générés en2k. - Si vous transmettez à la fois
sizeetaspect_ratio/resolution, ce sontaspect_ratio/resolutionqui 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
model | string | Oui | Nom du modèle. |
prompt | string | Oui | Description de l’image, ne doit pas être vide. Nous recommandons de ne pas dépasser quelques milliers de caractères. |
aspect_ratio | string | Non | Format d’image, auto par défaut. |
resolution | string | Non | 1k (par défaut) ou 2k. |
n | integer | Non | Nombre d’images, de 1 à 10, 1 par défaut. |
response_format | string | Non | b64_json (par défaut) ou url. Avec url, un lien d’image 88API est renvoyé. |
quality | string | Non | grok-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
imagesous forme de tableau, et ne transmettez pasimageetimagesen 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
1kpar défaut ; vous pouvez les remplacer avecaspect_ratioetresolution.
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
maskn’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
| Situation | HTTP | Message renvoyé |
|---|---|---|
| Appel de l’interface de chat ou Responses | 400 | <模型> 是生图模型,不支持 <接口> 接口。请改用: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 charge | 400 | 不支持的图片比例。支持:… (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 multipart | 400 | 上游拒绝了请求参数(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écharger | 400 | Message d’erreur relatif à l’image de référence |
| Plus de 3 images de référence | 502 | Upstream request failed |
| Échec de la modération du contenu | 400 | 图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 (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.
API des modèles d’image Gemini
Formats de requête de Gemini 3.1 Flash Image, Nano Banana 2.1 et Gemini 3 Pro Image via le protocole compatible OpenAI et le protocole natif Gemini, avec les formats d’image, résolutions et images de référence.
API de génération d’images Midjourney V8.2
Générez des images avec Midjourney V8.2 (standard, Fast et Turbo) via l’API 88API : point de terminaison, paramètres et options de prompt prises en charge.