Skip to main content
POST
Utilisez cette route pour créer des images à partir de texte avec les modèles d’image Grok. Le corps de la requête utilise application/json. model et prompt sont obligatoires.

​
Choisir un modèle

Choisissez un ID de modèle d’image Grok dans la page Modèles. Les exemples d’API utilisent grok-imagine-image-2.0. quality est disponible uniquement avec grok-imagine-image-2.0 et accepte low ou medium. Définissez-le explicitement lorsque votre application dépend d’un niveau de qualité particulier. Lorsque resolution est omis pour Image 2.0, CometAPI utilise 1k.

​
Configurer la sortie

  • Utilisez aspect_ratio pour sélectionner le format de sortie, ou utilisez auto pour laisser le modèle sélectionner le format.
  • Utilisez resolution pour demander une sortie 1k ou 2k.
  • Utilisez n pour demander de 1 à 10 images. La valeur par défaut est 1.
  • Utilisez response_format pour renvoyer des URL temporaires ou des données d’image encodées en Base64.
Pour un comportement propre à chaque modèle, consultez le guide de génération d’images xAI.
Téléchargez rapidement les résultats URL une fois la requête terminée. Les URL des images générées sont temporaires. Utilisez b64_json lorsque votre application nécessite les octets de l’image dans la réponse d’API.

Autorisations

​
Authorization
string
header
requis

Use your CometAPI API key as the bearer value.

Corps

application/json
​
model
enum<string>
requis

The Grok image model ID. See the Models page for available model IDs.

Options disponibles:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Exemple:

"grok-imagine-image-2.0"

​
prompt
string
requis

A text description of the image to generate.

Minimum string length: 1
Exemple:

"A glass observatory above a quiet alpine lake at sunrise"

​
n
integer
défaut:1

The number of images to generate. Use an integer from 1 through 10.

Plage requise: 1 <= x <= 10
​
aspect_ratio
enum<string>

The output shape. Use auto to let the model select the aspect ratio.

Options disponibles:
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
Exemple:

"16:9"

​
resolution
enum<string>
défaut:1k

The requested output resolution. Image 2.0 uses 1k when this field is omitted.

Options disponibles:
1k,
2k
Exemple:

"1k"

​
quality
enum<string>

Image quality for grok-imagine-image-2.0. This field is not available for the older Grok image model IDs.

Options disponibles:
low,
medium
Exemple:

"low"

​
response_format
enum<string>
défaut:url

The image representation in each response item. Use url for a temporary download URL or b64_json for Base64-encoded image bytes.

Options disponibles:
url,
b64_json

Réponse

200 - application/json

The generated image results.

​
data
object[]
requis

The generated images.

Minimum array length: 1
​
usage
object

Additional usage metadata returned for the request. Its contents can vary by model.

Dernière modification le 21 août 2026