Skip to main content
POST
Gebruik deze route om afbeeldingen vanuit tekst te maken met Grok-afbeeldingsmodellen. De hoofdtekst van de aanvraag gebruikt application/json. model en prompt zijn vereist.

​
Een model kiezen

Kies een Grok-afbeeldingsmodel-ID op de pagina Modellen. De API-voorbeelden gebruiken grok-imagine-image-2.0. quality grok-imagine-image-2.0 is alleen beschikbaar met low en accepteert medium. Stel dit expliciet in wanneer uw applicatie afhankelijk is van een bepaald kwaliteitsniveau. Wanneer resolution voor Image 2.0 wordt weggelaten, gebruikt CometAPI 1k.

​
De uitvoer configureren

  • Gebruik aspect_ratio om de uitvoervorm te selecteren, of gebruik auto om het model de vorm te laten selecteren.
  • Gebruik resolution om uitvoer in 1k of 2k aan te vragen.
  • Gebruik n om 1 tot en met 10 afbeeldingen aan te vragen. De standaardwaarde is 1.
  • Gebruik response_format om tijdelijke URL’s of Base64-gecodeerde afbeeldingsgegevens terug te geven.
Zie voor modelspecifiek gedrag de xAI-gids voor het genereren van afbeeldingen.
Download URL-resultaten direct nadat de aanvraag is voltooid. URL’s voor gegenereerde afbeeldingen zijn tijdelijk. Gebruik b64_json wanneer uw applicatie de afbeeldingsbytes in het API-antwoord nodig heeft.

Autorisaties

​
Authorization
string
header
vereist

Use your CometAPI API key as the bearer value.

Body

application/json
​
model
enum<string>
vereist

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

Beschikbare opties:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Voorbeeld:

"grok-imagine-image-2.0"

​
prompt
string
vereist

A text description of the image to generate.

Minimum string length: 1
Voorbeeld:

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

​
n
integer
standaard:1

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

Vereist bereik: 1 <= x <= 10
​
aspect_ratio
enum<string>

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

Beschikbare opties:
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
Voorbeeld:

"16:9"

​
resolution
enum<string>
standaard:1k

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

Beschikbare opties:
1k,
2k
Voorbeeld:

"1k"

​
quality
enum<string>

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

Beschikbare opties:
low,
medium
Voorbeeld:

"low"

​
response_format
enum<string>
standaard:url

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

Beschikbare opties:
url,
b64_json

Respons

200 - application/json

The generated image results.

​
data
object[]
vereist

The generated images.

Minimum array length: 1
​
usage
object

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

Laatst gewijzigd op 21 augustus 2026