Edición en varias iteraciones y retoque selectivo
En esta página
Actualizado el 3 de noviembre de 2026. Según la página Image Editing, la Image Prompting Guide y la referencia de la API de Imágenes de xAI: el punto de conexión
/v1/images/editsno dispone de parámetromask, ni en la documentación oficial ni enxai-sdk1.21.0, contrariamente a lo que afirmaba la versión anterior. El retoque se dirige mediante el prompt, y una zona se protege con precisión de píxel aplicando una máscara localmente tras la edición. Fuentes: Image Editing · Image Prompting Guide · Images API.
Encadenamiento de ediciones
La edición de imágenes cobra verdadera potencia cuando encadenas múltiples modificaciones. El principio, descrito por xAI, es sencillo: la salida de una edición se convierte en la entrada de la siguiente, lo que te permite partir de una imagen base para añadir detalles, ajustar el estilo o corregir aspectos, iteración tras iteración.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def edit_image(image_url, prompt):
"""Edita una imagen y devuelve la URL del resultado."""
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": image_url}
}
)
response.raise_for_status()
return response.json()["data"][0]["url"]
# Iteración 1: modificar el fondo
url_tour1 = edit_image(
"https://exemple.com/portrait.jpg",
"Replace the background with a modern office overlooking the city. "
"Keep the same person, pose, and framing."
)
# Iteración 2: ajustar la iluminación
url_tour2 = edit_image(
url_tour1,
"Make the light warm and dim, like late afternoon. "
"Keep the same person, decor, and framing."
)
# Iteración 3: añadir un elemento
url_tour3 = edit_image(
url_tour2,
"Place an open laptop on the desk, in front of the person. "
"Keep the same person, lighting, and framing."
)
print(f"Resultado final: {url_tour3}")
Mejores prácticas para la edición en varias iteraciones
La guía de xAI recomienda editar cuando el sujeto y la composición ya son correctos y solo es necesario cambiar entre uno y tres detalles; si el sujeto en sí es erróneo, es preferible regenerar la imagen. Cada iteración debe comenzar especificando la modificación y declarar a continuación, en una frase, qué elementos no deben moverse: el sujeto, el ángulo, el encuadre o la colocación de objetos. Según la guía, dos formulaciones fallan: una que empieza con «mantener todo», que apenas cambia nada, y otra que copia un prompt completo, lo cual recompone la escena; en este caso, el sujeto se desvía, un objeto se duplica o se transforma en un objeto vecino.
Ordena las iteraciones de lo general a lo específico: primero el fondo, la composición y el ambiente; después los accesorios y las correcciones finas, de modo que un cambio mayor tardío no deshaga los pequeños retoques previos.
Dos precauciones de seguridad completan el método. Descarga cada resultado intermedio tan pronto como se genere: las URL son temporales y perder la iteración 3 de una serie de cinco te obligaría a reiniciar desde la iteración 2. Además, inspecciona cada paso antes de encadenar: un defecto introducido en la iteración 1, como un dedo deformado o una sombra incoherente, acabará apareciendo en todas las iteraciones posteriores, ya que cada una parte de la imagen anterior.
Dirección de una zona mediante el prompt
La API no acepta máscaras: es el prompt quien dirige. Designa la parte a modificar con la mayor precisión posible, indicando su nombre, posición o material, y especifica qué debe permanecer idéntico.
url_chapeau = edit_image(
url_tour3,
"Replace the person's cap with a wide-brimmed straw hat. "
"Keep the same face, hairstyle, decor, and framing."
)
Cuando una corrección no surte efecto, la guía recomienda cambiar las palabras en lugar de repetir la misma solicitud, designando claramente la parte de la imagen a corregir y lo que debe mostrar. Para ensamblar varias imágenes, como un producto en un decorado o un personaje trasladado de una imagen a otra, la edición acepta hasta cinco imágenes de origen (lección 7).
Protección de una zona con precisión de píxel: la máscara local
Si una parte de la imagen no debe moverse ni un píxel, como un logotipo, un rostro o texto, aplica la máscara localmente después de la edición: conservas la zona original y tomas de la edición únicamente lo que queda fuera de dicha zona. Con Pillow, Image.composite(image1, image2, mask) copia image1 donde la máscara es blanca y mantiene image2 donde es negra:
from PIL import Image, ImageDraw
original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)
# Máscara: blanco = tomar edición, negro = mantener original
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0) # zona protegida, p. ej., un logotipo
resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")
Las tres imágenes deben tener el mismo tamaño. El redimensionado asume que la edición ha mantenido la relación de aspecto de la fuente: verifícalo o impónla mediante el parámetro aspect_ratio de la solicitud. La máscara no impide que el modelo toque la zona; permite restaurarla posteriormente.
Canalización completa de edición
A continuación se muestra un ejemplo de canalización estructurada que mantiene el historial de cada iteración:
class ImageEditor:
def __init__(self, api_key):
self.headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
self.history = []
def edit(self, image_url, prompt):
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=self.headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": image_url}
}
)
response.raise_for_status()
result_url = response.json()["data"][0]["url"]
self.history.append({
"prompt": prompt,
"input": image_url,
"output": result_url
})
return result_url
Puntos clave
- La edición en varias iteraciones encadena resultados: cada salida se convierte en la entrada de la siguiente edición
- Edita cuando el sujeto y la composición sean correctos y solo necesites cambiar entre uno y tres detalles
- En cada iteración: indica primero la modificación y después qué debe permanecer idéntico
- La API no tiene parámetro
mask: dirige mediante el prompt y protege una zona con una máscara local aplicada tras la edición - Las URL de salida son temporales: descarga los resultados intermedios