Introducción
Envía la descripción de la escena y elige una composición cuadrada, vertical u horizontal.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Empresa | xAI |
| Identificador | grok/imagine-image-2.0 |
| Flujos de imagen | Generación de texto a imagen y edición de imagen a imagen |
| Máximo del prompt | Hasta 8.000 caracteres en ambos flujos |
| Fuentes para edición | De 1 a 5 imágenes en |
| Nombres de referencia | Image 1, Image 2 y siguientes según orden de entrada |
| Relaciones admitidas | 1:1, 2:3, 3:2, 16:9, 9:16 |
| Lienzo inicial | 1:1 en generación y edición |
| Precio | Fijo por imagen; la relación no cambia tarifa; las tareas fallidas no se cobran |
| Disponibilidad del archivo | Los archivos generados se eliminan tras 14 días |
Funciones y aspectos destacados
Un probador y reflejos repetidos
La muestra en 2:3 presenta a un hombre sosteniendo una camisa de seda entre espejos inclinados y luz cálida de boutique. Su reflejo se repite consistentemente. Usa la escena para orientar juntos sujeto, prenda, lugar y luz; revisa cada reflejo de tu salida sin asumir lo mismo para todo arreglo.
Un jardinero de musgo a escala de bonsái
La prueba del robot jardinero representó un personaje cubierto de musgo regando un bonsái con textura macro convincente. Sujeto pequeño, acción clara y fotografía cercana hacen legible la escala. Describe superficie y luz y evalúalas en la salida; la prueba respalda esa miniatura sin dar una puntuación general de calidad.
Cambia la etiqueta y mantiene el entorno
En la prueba, flores de ciruelo pintadas y pan de oro sustituyeron el diseño sencillo de la lata, conservando tapa, mesa y luz. Demuestra una edición con metas de conservación nombradas. Identifica la lata como Image 1, explica etiqueta y detalles que deben quedar y contrasta con la foto de origen.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Escribe hasta 8.000 caracteres para describir la escena; este campo de texto no selecciona un precio distinto para la imagen. mínimo 1 caracteres · máximo 8000 caracteres |
aspect_ratio | No | Elige 1:1, 2:3, 3:2, 16:9 o 9:16, con 1:1 como valor predeterminado; las cinco formas tienen el mismo precio. |
Precios
$0.028 / imagen
Cada imagen de Grok generada tiene un cargo fijo sin importar su forma; una generación fallida no se cobra.
Casos de uso
Conceptos de moda en boutique
Planea un retrato con ropa, luz cálida de tienda y espejos inclinados. La muestra de probador usa 2:3 y repite al mismo hombre de forma consistente en reflejos: una referencia concreta de composición.
Mundos pequeños con materiales detallados
Describe un personaje pequeño en una tarea reconocible en lugar de enumerar objetos inconexos. El robot cubierto de musgo regó un bonsái y mostró el tratamiento textural de una escena macro.
Diseño de empaque en una lata existente
Parte de una foto de producto aceptada y pide otra etiqueta. La edición medida añadió flores de ciruelo pintadas a mano y pan de oro, manteniendo tapa, mesa y luz.
Ediciones con papeles asignados a referencias
Usa hasta cinco entradas si necesitas más de una fuente. Explica qué aporta cada número y qué conservar; disponer de esas entradas es un control, sin demostrar que toda composición coincidirá con la referencia.
Conceptos verticales y horizontales
Elige lienzo alto, cuadrado o ancho antes de generar según su destino. Generación y edición ofrecen cinco relaciones; cambiar entre ellas mantiene la tarifa por imagen.
Guía de prompts y consejos prácticos
Elige entre crear y modificar
Parte de una escena escrita para una imagen nueva o aporta de una a cinco fuentes para revisar. Usa fotos autorizadas; las personas de las entradas de edición deben ser adultas y sin suplantación.
Explica escena o cambio
Da a una escena nueva sujeto, acción, entorno y luz. En edición, asigna papeles a Image 1, Image 2 y siguientes y nombra los detalles por conservar.
Ajusta la forma al destino
Escoge 1:1, 2:3, 3:2, 16:9 o 9:16 según la composición. El valor predeterminado es cuadrado y la relación no modifica la tarifa por imagen.
Revisa y conserva los detalles
Compara la imagen con el encargo y revisa reflejos u objetos conservados si importan. Descarga durante los 14 días disponibles y guarda su prompt.
Crea una escena desde un encargo escrito
Grok Imagine Image 2.0 texto a imagen genera desde tu descripción. Empieza aquí si tienes una escena en mente sin necesitar una foto que aporte sus detalles. Robot en miniatura y retrato de probador muestran dos maneras de organizar el encargo en torno a sujeto y entorno.
La generación tiene prompt y control de relación. Elige la forma para el diseño y dedica el texto a lo que debe aparecer dentro. Para una foto aceptada de producto que necesite otra etiqueta u otro cambio dirigido, usa imagen a imagen.
Parámetros y composición
| Parámetro | Valor admitido | Cómo usarlo |
|---|---|---|
| prompt | Descripción de hasta 8.000 caracteres | Sujeto, acción, materiales, entorno y luz. |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | Proporciones de lienzo; 1:1 predeterminado. |
Una escena alta puede usar 2:3 o 9:16 y una ancha 3:2 o 16:9. El probador usa 2:3 para enmarcar hombre y espejos en vertical. Si no cambias aspect_ratio, empieza cuadrado. Decide el control incluso si el prompt dice vertical.
Redacta un prompt que guíe la imagen
Vincula sujeto y acción
Da al sujeto central una tarea legible. El robot jardinero riega un bonsái: personaje, agua y planta forman una actividad. Un retrato de probador puede mostrar al hombre sosteniendo la camisa de seda para relacionar la prenda con la escena. Si incluyes personas, indica una edad de treinta años en adelante.
Da función a superficies y luz
Los materiales explican qué ver: musgo contra metal, seda contra pantalones de vestir o espejo pulido en tienda cálida. Combínalos con dirección fotográfica macro o luz suave de boutique. Elige detalles concretos adecuados al sujeto sin apilar estilos inconexos.
Describe lo que inspeccionarás
Si hay espejos, explica su relación con el sujeto y comprueba reflejos. Para escala de miniatura, describe planta próxima y distancia de vista. Comunican el encargo sin garantizar precisión física. Anota detalles importantes para juzgar según los mismos requisitos.
Qué mostraron los ejemplos
- El robot con musgo regó un bonsái con buena textura macro. Respalda el estudio de material mostrado sin abarcar toda escena de objetos pequeños.
- El probador devolvió un retrato 2:3 de hombre sin camisa sosteniendo camisa de seda. Los espejos inclinados repitieron su reflejo consistentemente.
- La lata pertenece a edición: cambió etiqueta conservando tapa, mesa y luz. Usa ese endpoint si esos detalles existentes son tu punto de partida.
La galería reúne resultados observables. Miniatura y reflejos son ejemplos separados, sin promesa medida de igual calidad para otro prompt. Las ideas adicionales son sugerencias, no otras pruebas.
Precio y límites de solicitud
Cada imagen usa tarifa fija; elegir otra relación admitida no la cambia. Consulta el importe actual en la página de Grok Imagine Image 2.0 antes de empezar. Una generación fallida no se cobra.
El desarrollador aplica su propio filtro. Una solicitud marcada se rechaza sin cargo. Respeta límite de texto y relaciones indicadas. Estos controles no incluyen selector de calidad o resolución: no importes ajustes de reseñas generales.
Cada imagen terminada queda descargable 14 días y luego se elimina. Guarda la aceptada con texto y relación. Si necesitas reintentar un detalle, reformula ese requisito claramente y contrasta la siguiente salida con el mismo encargo.
Elige el flujo de la siguiente tarea
Lleva una fuente a imagen a imagen para una revisión concreta con detalles por conservar. Para otro requisito de lienzo, Nano Banana 2 Lite ofrece catorce relaciones de generación. Para carteles con palabras proporcionadas, considera Ideogram 4.5, cuya prueba reprodujo título y línea de apoyo con claridad. Elige por controles e inspecciona tu salida sin una clasificación general de modelos.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-imagine-image-2.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.










