Skip to main content
POST
Este endpoint también acepta el alias grok-imagine-1.5-ext, equivalente a grok-imagine-1.5-apimart e intercambiable.

Authorizations

string
requerido
Todas las API requieren autenticación Bearer TokenObtener API Key:Visite la página de gestión de API KeyAñádala en la cabecera de la solicitud:

Body

string
predeterminado:"grok-imagine-1.5-apimart"
requerido
Nombre del modelo de generación de imágenesModelos admitidos:
  • grok-imagine-1.5-apimart - generación y edición de imágenes Grok (alias grok-imagine-1.5-ext)
Ejemplo:"grok-imagine-1.5-ext"
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción textual para generación o edición de imagen
string[]
Lista de URL de imágenes de referencia. Omitir para text-to-image; incluir para edición.
  • Este modelo admite de 1 a 5 imágenes de referencia
  • Solo acepta URL absolutas http:// o https:// accesibles públicamente
  • Suba primero las imágenes locales con POST /v1/uploads/images y use la url devuelta
string
predeterminado:"1:1"
Tamaño de la imagen de salidaFormatos admitidos:
  • 1:1 - Cuadrado (predeterminado)
  • 16:9 - Horizontal panorámico
  • 9:16 - Vertical
  • 3:2 - Horizontal
  • 2:3 - Vertical
integer
predeterminado:1
Número de imágenes a generarRango: 1-10 (mínimo 1, máximo 10)⚠️ Nota: debe ser un número puro (p. ej. 1), sin comillas; de lo contrario habrá error

Response

integer
Código de estado de la respuesta
array
Array de datos de respuesta

Casos de uso

Caso 1: Text-to-Image

Caso 2: Text-to-Image (tamaño y cantidad)

Caso 3: Edición de imagen (fondo)

Caso 4: Edición de imagen (estilo)

Modelos oficiales

grok-imagine-image y grok-imagine-image-quality usan el mismo flujo de tareas asíncronas que los demás modelos de imagen. Tras enviar la solicitud, use el ID devuelto y consulte el estado de la tarea hasta que termine o falle.
No envíe quality. Sin image_urls se genera desde texto; una imagen activa la edición y varias imágenes sirven como referencias múltiples.

Parámetros de solicitud

Valores de aspect_ratio: 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.

Respuesta de creación de tarea

202
Use data.id o data.poll_url hasta que el estado sea completed o failed.