Skip to main content
POST
Bruk denne ruten til å opprette bilder fra tekst med Grok-bildemodeller. Forespørselsteksten bruker application/json. model og prompt er påkrevd.

​
Velg en modell

Velg en Grok-bildemodell-ID fra Models-siden. API-eksemplene bruker grok-imagine-image-2.0. quality er bare tilgjengelig med grok-imagine-image-2.0 og godtar low eller medium. Angi den eksplisitt når applikasjonen din er avhengig av et bestemt kvalitetsnivå. Når resolution utelates for Image 2.0, bruker CometAPI 1k.

​
Konfigurer utdataene

  • Bruk aspect_ratio for å velge utdataformatet, eller bruk auto for å la modellen velge formatet.
  • Bruk resolution for å be om utdata i 1k eller 2k.
  • Bruk n for å be om fra 1 til 10 bilder. Standardverdien er 1.
  • Bruk response_format for å returnere midlertidige URL-er eller Base64-kodede bildedata.
For modellspesifikk atferd, se veiledningen for xAI-bildegenerering.
Last ned URL-resultater straks etter at forespørselen er fullført. Genererte bilde-URL-er er midlertidige. Bruk b64_json når applikasjonen din trenger bildebytene i API-responsen.

Autorisasjoner

​
Authorization
string
header
påkrevd

Use your CometAPI API key as the bearer value.

Kropp

application/json
​
model
enum<string>
påkrevd

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

Tilgjengelige alternativer:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Eksempel:

"grok-imagine-image-2.0"

​
prompt
string
påkrevd

A text description of the image to generate.

Minimum string length: 1
Eksempel:

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

​
n
integer
standard:1

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

Nødvendig område: 1 <= x <= 10
​
aspect_ratio
enum<string>

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

Tilgjengelige alternativer:
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
Eksempel:

"16:9"

​
resolution
enum<string>
standard:1k

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

Tilgjengelige alternativer:
1k,
2k
Eksempel:

"1k"

​
quality
enum<string>

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

Tilgjengelige alternativer:
low,
medium
Eksempel:

"low"

​
response_format
enum<string>
standard:url

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

Tilgjengelige alternativer:
url,
b64_json

Svar

200 - application/json

The generated image results.

​
data
object[]
påkrevd

The generated images.

Minimum array length: 1
​
usage
object

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

Sist endret 21. august 2026