Introducción
Numera en el prompt las imágenes aportadas e indica el reemplazo o cambio deseado.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| 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í | Solicita cambios en hasta 8.000 caracteres y nombra las fuentes como Image 1, Image 2 y así sucesivamente; la extensión del prompt no cambia la tarifa fija por imagen. mínimo 1 caracteres · máximo 8000 caracteres |
image_urls | Sí | Aporta de 1 a 5 URL de imágenes de origen para la edición; la cantidad de entradas no corresponde a un nivel de precio aparte. mínimo 1 elementos · máximo 5 elementos |
aspect_ratio | No | La edición admite 1:1, 2:3, 3:2, 16:9 y 9:16; el valor predeterminado es 1:1 y todas las formas tienen el mismo cargo. |
Precios
$0.028 / imagen
Las ediciones de Grok se cobran por imagen de salida con una tarifa fija; la proporción no cambia esa tarifa y las ediciones sin resultado no tienen costo.
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.
Modifica una imagen con cambios nombrados
El editor Grok Imagine Image 2.0 parte de una a cinco fuentes y una instrucción escrita. Úsalo cuando foto o diseño ya contengan detalles por mantener. La fuente aporta el material y prompt explica revisión y conservación.
La lata de té es un ejemplo de empaque concreto. Recibió flores de ciruelo pintadas y pan de oro conservando tapa, mesa y luz. Orienta cambios similares sin establecer que toda edición deje intactos todos los detalles restantes.
Entradas y forma de salida
| Parámetro | Valor admitido | Instrucción por preparar |
|---|---|---|
| prompt | Hasta 8.000 caracteres | Cambios, papeles de referencias y detalles retenidos. |
image_urls | De 1 a 5 URLs de fuentes | Alinea orden con Image 1, Image 2 y siguientes del prompt. |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | Proporciones de salida; 1:1 predeterminado. |
Una fuente basta para una etiqueta como la prueba medida. Añade otra referencia si aporta algo identificable. Image 1 puede aportar foto y Image 2 diseño de etiqueta: es un patrón propuesto, separado del resultado medido.
Configura aspect_ratio como parte del encargo. Las formas coinciden con generación y el predeterminado documentado es cuadrado. Elige vertical u horizontal según destino sin dejar esa decisión en una frase de escena.
Construye la instrucción de edición
Asigna funciones distintas
Menciona posiciones directamente. Indica qué imagen contiene lata, cuál aporta otro elemento y cuál determina entorno si importa. Contrasta nombres con orden de image_urls antes de enviar. Más referencias aportan fuentes, sin reemplazar la explicación de sus relaciones.
Concreta el reemplazo
En empaque, el cambio son flores de ciruelo pintadas a mano con acentos de pan de oro. Define qué aparecerá en la lata. En tu encargo, identifica objeto y diseño, material o lugar revisados sin pedir una mejora indefinida.
Enumera qué conservar
Después del cambio, lista lo que debe permanecer. La lata identifica tapa, mesa y luz como detalles fijos. Revisa cada uno frente a la fuente al recibir. Si cambia algo importante, nómbralo claramente en la próxima instrucción y vuelve a evaluar.
Prepara responsablemente las fuentes de retrato
Evita hacerte pasar por otra persona y, si incluyes retratos, utiliza únicamente fotos de adultos con autorización. Las ideas de retrato especifican treinta años o más. Describe ropa, ambiente, lugar y luz como encargo de edición, vinculando lo que preservarás a la persona autorizada de entrada.
Qué estableció la prueba de edición
La lata medida incorporó el diseño floral de pan de oro conservando tapa, mesa e iluminación. Demuestra un cambio concreto con lista de conservación. No garantiza identidad, letras exactas ni rondas repetidas.
Los espejos del probador son texto a imagen y no prueban consistencia de edición. Los prompts propuestos de retrato y producto de dos fuentes también son ideas para solicitudes nuevas. Compara la edición con sus fuentes reales, sin usar otro ejemplo como prueba de esa composición.
Cobro, filtrado y conservación
Las ediciones se cobran por imagen de salida a tarifa fija. Cambiar aspect_ratio no altera el precio. Consulta la tarifa actual del modelo antes de enviar; las tareas sin éxito no se cobran.
El desarrollador filtra contenido y rechaza sin cargo las solicitudes marcadas. Planea dentro de límites de entradas y prompt. Los controles listados son prompt, image_urls y aspect_ratio; máscaras o calidad mencionadas en otro lugar no figuran en esta tabla.
Descarga en los 14 días de conservación, tras los que se eliminan los archivos. Guarda fuentes, orden, instrucción aceptada y resultado juntos para dar base clara al próximo cambio.
Cuándo conviene otro endpoint
Usa texto a imagen de esta familia para una escena sin fuentes por conservar. Considera Nano Banana 2 Lite si necesitas más de cinco referencias: admite diez. Para diseños con texto proporcionado y cambios guiados por máscara, Ideogram 4.5 ofrece esos controles. Son diferencias de entradas y controles, sin afirmar que un modelo conserve cada detalle.
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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.











