Skip to main content
POST
Usa questa route per creare immagini dal testo con i modelli di immagini Grok. Il corpo della richiesta utilizza application/json. model e prompt sono obbligatori.

​
Scegli un modello

Scegli un ID modello di immagini Grok dalla pagina dei modelli. Gli esempi API utilizzano grok-imagine-image-2.0. quality è disponibile solo con grok-imagine-image-2.0 e accetta low o medium. Impostalo esplicitamente quando l’applicazione dipende da un particolare livello di qualità. Quando resolution viene omesso per Image 2.0, CometAPI utilizza 1k.

​
Configura l’output

  • Usa aspect_ratio per selezionare la forma dell’output oppure auto per lasciare che il modello selezioni la forma.
  • Usa resolution per richiedere output 1k o 2k.
  • Usa n per richiedere da 1 a 10 immagini. Il valore predefinito è 1.
  • Usa response_format per restituire URL temporanei o dati immagine codificati in Base64.
Per il comportamento specifico del modello, consulta la guida alla generazione di immagini di xAI.
Scarica prontamente i risultati sotto forma di URL dopo il completamento della richiesta. Gli URL delle immagini generate sono temporanei. Usa b64_json quando l’applicazione necessita dei byte dell’immagine nella risposta API.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Use your CometAPI API key as the bearer value.

Corpo

application/json
​
model
enum<string>
obbligatorio

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

Opzioni disponibili:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Esempio:

"grok-imagine-image-2.0"

​
prompt
string
obbligatorio

A text description of the image to generate.

Minimum string length: 1
Esempio:

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

​
n
integer
predefinito:1

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

Intervallo richiesto: 1 <= x <= 10
​
aspect_ratio
enum<string>

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

Opzioni disponibili:
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
Esempio:

"16:9"

​
resolution
enum<string>
predefinito:1k

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

Opzioni disponibili:
1k,
2k
Esempio:

"1k"

​
quality
enum<string>

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

Opzioni disponibili:
low,
medium
Esempio:

"low"

​
response_format
enum<string>
predefinito:url

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

Opzioni disponibili:
url,
b64_json

Risposta

200 - application/json

The generated image results.

​
data
object[]
obbligatorio

The generated images.

Minimum array length: 1
​
usage
object

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

Ultima modifica il 21 agosto 2026