Skip to main content
POST
Usa esta ruta para crear imágenes a partir de texto con modelos de imagen Grok. El cuerpo de la solicitud usa application/json. model y prompt son obligatorios.

​
Elegir un modelo

Elige un ID de modelo de imagen Grok en la página de modelos. Los ejemplos de la API usan grok-imagine-image-2.0. quality solo está disponible con grok-imagine-image-2.0 y acepta low o medium. Establécelo explícitamente cuando tu aplicación dependa de un nivel de calidad concreto. Cuando se omite resolution para Image 2.0, CometAPI usa 1k.

​
Configurar la salida

  • Usa aspect_ratio para seleccionar la forma de salida, o usa auto para que el modelo seleccione la forma.
  • Usa resolution para solicitar una salida 1k o 2k.
  • Usa n para solicitar de 1 a 10 imágenes. El valor predeterminado es 1.
  • Usa response_format para devolver URL temporales o datos de imagen codificados en Base64.
Para conocer el comportamiento específico del modelo, consulta la guía de generación de imágenes de xAI.
Descarga los resultados de URL inmediatamente después de que se complete la solicitud. Las URL de las imágenes generadas son temporales. Usa b64_json cuando tu aplicación necesite los bytes de la imagen en la respuesta de la API.

Autorizaciones

​
Authorization
string
header
requerido

Use your CometAPI API key as the bearer value.

Cuerpo

application/json
​
model
enum<string>
requerido

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

Opciones disponibles:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Ejemplo:

"grok-imagine-image-2.0"

​
prompt
string
requerido

A text description of the image to generate.

Minimum string length: 1
Ejemplo:

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

​
n
integer
predeterminado:1

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

Rango requerido: 1 <= x <= 10
​
aspect_ratio
enum<string>

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

Opciones 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
Ejemplo:

"16:9"

​
resolution
enum<string>
predeterminado:1k

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

Opciones disponibles:
1k,
2k
Ejemplo:

"1k"

​
quality
enum<string>

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

Opciones disponibles:
low,
medium
Ejemplo:

"low"

​
response_format
enum<string>
predeterminado:url

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

Opciones disponibles:
url,
b64_json

Respuesta

200 - application/json

The generated image results.

​
data
object[]
requerido

The generated images.

Minimum array length: 1
​
usage
object

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

Última modificación el 21 de agosto de 2026