Skip to main content
POST
Use esta ruta para crear imágenes a partir de texto con modelos de imágenes de Grok. El cuerpo de la solicitud usa application/json. La solicitud admite model, prompt, n, aspect_ratio, resolution y response_format.

​
Elija un modelo

Elija un ID de modelo de imágenes de Grok en la página de modelos. Los ejemplos de API usan grok-imagine-image-quality.

​
Configure la salida

  • Use aspect_ratio para seleccionar la forma de salida o auto para que el modelo seleccione la forma.
  • Use resolution para solicitar salida 1k o 2k.
  • Use n para solicitar hasta 10 imágenes.
  • Use response_format para devolver URL temporales o datos de imagen codificados en Base64.
Para obtener detalles sobre los parámetros del proveedor, consulte la guía de generación de imágenes de xAI.
Descargue los resultados de URL después de que se complete la solicitud. Las URL de imágenes generadas pueden caducar.

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

"grok-imagine-image-quality"

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

The requested output resolution.

Opciones disponibles:
1k,
2k
Ejemplo:

"1k"

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

Usage details for the request.