Skip to main content
POST
Utilisez cette route pour créer des images à partir de texte avec les modèles d’images Grok. Le corps de la requête utilise application/json. La requête prend en charge model, prompt, n, aspect_ratio, resolution et response_format.

​
Choisir un modèle

Choisissez un ID de modèle d’image Grok dans la page des modèles. Les exemples d’API utilisent grok-imagine-image-quality.

​
Configurer la sortie

  • Utilisez aspect_ratio pour sélectionner le format de sortie, ou auto pour laisser le modèle sélectionner le format.
  • Utilisez resolution pour demander une sortie 1k ou 2k.
  • Utilisez n pour demander jusqu’à 10 images.
  • Utilisez response_format pour renvoyer des URL temporaires ou des données d’image encodées en Base64.
Pour en savoir plus sur les paramètres du fournisseur, consultez le guide de génération d’images xAI.
Téléchargez les résultats fournis sous forme d’URL une fois la requête terminée. Les URL des images générées peuvent expirer.

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

"grok-imagine-image-quality"

​
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>

The requested output resolution.

Options disponibles:
1k,
2k
Exemple:

"1k"

​
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
requis

Usage details for the request.