Guía de edición FLUX 3 Image: referencias y recuadros

FLUX 3 Image acepta hasta diez imágenes de referencia, pero una edición útil empieza con una pregunta más concreta: ¿qué parte de la imagen debe cambiar? Black Forest Labs documenta tanto la edición mediante instrucciones como un formato de composición que nombra elementos individuales, les asigna recuadros y distingue sus posiciones originales de las deseadas.^[1][2]

Esta guía explica cómo elegir entre esos enfoques, escribir los datos de los recuadros dentro de un prompt y comprobar el resultado. Los ejemplos siguientes son plantillas ilustrativas de prompts, no resultados de generación reportados. Usa la página del modelo FLUX 3 Image para consultar los controles y precios actuales de reAPI y la documentación de la API para el contrato de solicitud.

Resumen

• Empieza con una referencia y una instrucción específica cuando un objeto necesite un cambio claro. Los recuadros introducidos manualmente son opcionales para la edición habitual de imágenes.^[1]
• El orden de las referencias importa: ref_image_0 es la primera imagen y ref_image_1 es la segunda. Asigna a cada referencia una función clara.^[2]
• Incluye la descripción y la tabla de elementos juntas dentro de prompt. Los recuadros delimitadores no son un parámetro independiente de nivel superior de la solicitud.^[2]
• Las coordenadas usan [top, left, bottom, right] en una cuadrícula normalizada de 0–1000. No son coordenadas de píxeles de la imagen.^[2]
• Trata los recuadros como instrucciones de posición. BFL indica que no funcionan como máscaras de recorte y que también debes revisar los píxeles sin modificar.^[2]

Empieza una edición de FLUX 3 Image con un cambio que puedas nombrar

Para una sola imagen, escribe una instrucción que identifique el objeto y el resultado deseado. La guía de edición de BFL recomienda nombrar el elemento con suficiente precisión para que solo haya una coincidencia. El modelo puede ampliar una instrucción e inferir recuadros para muchas ediciones; no necesitas aportar una tabla completa de elementos en cada solicitud.^[1]

Imagina una fotografía de producto con una taza color crema sobre una mesa de madera. Un prompt inicial podría ser:

Change the cream ceramic mug beside the closed notebook to a deep teal glaze.
Keep the mug's handle shape, the notebook, the wooden table, the camera angle,
and the soft light from the left unchanged.

Esto da al cambio un sujeto reconocible y define las partes que revisarás después. Si hay dos tazas, especifica cuál. Si el asa debe seguir visible, indícalo. Una petición genérica de «mejorar la foto» deja esas decisiones al modelo.

Para FLUX 3 Image, sugerimos intentar primero la edición más pequeña que puedas describir con claridad. Añade recuadros explícitos cuando la ubicación sea ambigua, aparezcan varios objetos parecidos o deba cambiar la propia composición. Es una estrategia de edición, no una afirmación de que un estilo de prompt siempre funcione.

Asigna una función a cada referencia

FLUX 3 Image admite hasta diez referencias. BFL describe dos formas de mencionarlas: su posición, como «Imagen 1», o su identificador indexado, empezando por ref_image_0. La primera referencia también determina la relación de aspecto de salida cuando una solicitud de edición usa auto.^[1][2]

Para un concepto de habitación, las funciones podrían ser:

Una instrucción ilustrativa sería: «Usa la Imagen 1 como habitación. Coloca el sillón de la Imagen 2 junto a la ventana. Añade un cojín con el estampado de la Imagen 3. Mantén la vista de cámara y los muebles existentes de la habitación sin cambios».

Guarda ese orden de referencias en el registro de la tarea. Reordenar las entradas manteniendo el mismo prompt cambia qué imagen aporta cada función. Tampoco tiene mucho sentido llenar los diez espacios si la descripción solo necesita dos. El límite útil depende de la claridad con la que puedas explicar qué aporta cada referencia.

Para una solicitud de FLUX 3 Image en reAPI, proporciona las URL de referencia en image_urls. La referencia de la API de FLUX 3 Image documenta las URL aceptadas y los límites de solicitud; los identificadores del prompt siguen contando desde cero.

Incluye los datos de composición dentro del prompt

FLUX 3 Image usa una descripción seguida de un array JSON de elementos. Para una composición nueva, cada elemento tiene id, bbox y desc. Menciona el id correspondiente entre corchetes angulares en la descripción y añade después la tabla a la misma cadena de prompt.^[2]

Este es un ejemplo ilustrativo de composición cuadrada con una taza a la izquierda y un cuaderno a la derecha:

A quiet overhead product photograph of a teal mug <mug_1> and a closed
cream notebook <notebook_1> on a pale wooden desk <desk_1>.

[
  {"id":"desk_1","bbox":[0,0,1000,1000],"desc":"A pale wooden desk in soft daylight."},
  {"id":"mug_1","bbox":[300,120,760,450],"desc":"One teal ceramic mug with its handle visible."},
  {"id":"notebook_1","bbox":[230,540,820,900],"desc":"A closed cream notebook without lettering."}
]

Los números describen posiciones relativas. [0,0,500,500] es el cuarto superior izquierdo de la imagen. Cambiar la resolución no convierte esos valores en píxeles. Cambiar la relación de aspecto estira la cuadrícula de coordenadas con el encuadre, así que usa la misma relación para la que diseñaste la composición.^[2]

Cuando crees una solicitud mediante código, serializa el array y añádelo a la descripción. Así evitas escapar manualmente cada comilla dentro del JSON anidado. No envíes un campo bbox independiente solo porque el prompt contiene datos de recuadros.

La edición usa recuadros de origen y destino

Una edición necesita más información que una composición nueva: de dónde procede el elemento y dónde debe terminar. El formato de edición de FLUX 3 Image usa from, src_bbox y tgt_bbox para ello.^[2]

Por ejemplo, una fila para mover la taza podría ser:

{
  "id": "mug_1",
  "from": "ref_image_0",
  "src_bbox": [300, 120, 760, 450],
  "tgt_bbox": [300, 200, 760, 530],
  "desc": "The teal ceramic mug with the same shape and visible handle."
}

La instrucción que la acompaña debe indicar que la taza se mueve a la derecha mientras el cuaderno y la mesa permanecen iguales. Añade filas de conservación para los elementos que deban quedarse en su sitio. Esas filas usan las mismas coordenadas de origen y destino.

Para recolorear, el patrón documentado por BFL consiste en una fila nueva: from: null, src_bbox: null y un recuadro de destino que describa la apariencia deseada. Para eliminar, conserva la referencia y el recuadro de origen y establece el recuadro de destino en null. Indica también la eliminación en la instrucción escrita. La instrucción y la tabla deben coincidir.^[2]

Estas coordenadas de ejemplo corresponden a la composición hipotética anterior. Mide tu propia imagen antes de reutilizarlas; un objeto JSON válido puede seguir señalando el objeto equivocado.

Elige resolución y grounding según lo que necesitas

FLUX 3 Image tiene cinco niveles de resolución: 768sq, 1k, 1.5k, 2k y 4k. El valor predeterminado es 1k. Su opción de grounding está activada de forma predeterminada y permite búsquedas web y de imágenes antes de generar; establecerla en false desactiva ese paso de búsqueda.^[3]

Estos controles responden a preguntas distintas. La resolución selecciona el nivel de salida. El grounding decide si el modelo puede buscar información de apoyo más allá del prompt y las entradas aportadas. Para una composición de estudio ficticia, desactivarlo puede encajar con tu flujo de trabajo. Para un encargo sobre un sujeto real o una referencia visual actual, decide si la búsqueda resulta útil y verifica igualmente el resultado.

BFL describe generación nativa 2K y 4K para FLUX 3 Image, pero una salida mayor no demuestra que una edición pequeña haya preservado un rostro, etiqueta o textura. Revisa la región importante al tamaño entregado. Consulta los precios actuales de FLUX 3 Image antes de elegir el nivel final, en lugar de copiar una tarifa antigua en tu flujo de trabajo.^[4]

Revisa las partes intactas con el mismo cuidado que la edición

La precisión más útil de la documentación de recuadros de BFL es que orientan la posición y la escala; no recortan un elemento con una máscara rígida. Su ejemplo de eliminación dice que los píxeles fuera de los recuadros editados normalmente permanecen idénticos. Eso invita a comparar resultados, no constituye una promesa universal de ausencia de desviaciones.^[2]

Para el ejemplo de la taza, revisa el asa, el borde del cuaderno, la veta de la mesa y el límite de la sombra. Si necesitas varias ediciones, conserva el original aprobado y compara cada resultado con él. Una nueva composición atractiva puede incumplir un encargo que exigía mantener intacto el cuaderno original.

Un registro sencillo de revisión puede incluir el orden de entrada, el prompt, la tabla de elementos, la relación de aspecto, la resolución y una nota breve de aceptación o rechazo. Para ediciones sucesivas, conserva la imagen aceptada anteriormente. Es un procedimiento de revisión sugerido; este artículo no afirma haber medido una tasa de reintentos ni una precisión de edición.

Preguntas sobre la edición con FLUX 3 Image

¿Puedo editar una imagen sin recuadros delimitadores?

Sí. Envía una referencia y una instrucción escrita. BFL documenta la edición directa y dice que el modelo puede inferir recuadros de elementos para muchas ediciones. Proporciona tú los recuadros cuando necesites instrucciones de posición explícitas.^[1]

¿Cuántas imágenes de referencia puedo usar?

Hasta diez. Describe qué aporta cada imagen y conserva su orden. La primera es ref_image_0; en lenguaje habitual es la «Imagen 1».^[1]

¿Los recuadros delimitadores se miden en píxeles?

No. Usan enteros normalizados de 0 a 1000 en el orden [top,left,bottom,right]. Un recuadro cubre la parte correspondiente del encuadre independientemente de la resolución de salida.^[2]

¿La edición de imagen a imagen preserva la relación de aspecto original?

En una solicitud de edición con aspect_ratio: "auto", la primera referencia determina la relación de aspecto. Elige una relación explícita si la salida necesita otra forma y diseña los recuadros de composición para esa forma.^[1]

¿Se garantiza una edición exacta de píxeles fuera del recuadro?

No lo des por hecho. La guía técnica de BFL matiza la preservación e indica que los recuadros no son máscaras de recorte. Compara el archivo devuelto con el original en todas las zonas donde conservar los píxeles sea un requisito de aceptación.^[2]

¿Puedo descargar FLUX 3 Image para usarlo localmente?

BFL anuncia una licencia comercial de pesos para empresas que quieran ajustar y desplegar FLUX 3 Image en su propia infraestructura. Esa oferta no debe interpretarse como prueba de una publicación de pesos abiertos descargables libremente. Consulta las condiciones de licencia actuales con BFL. Nuestra guía de pesos de FLUX 3 Image distingue la oferta comercial de una descarga pública.^[4]

Revisa una edición de FLUX 3 Image antes del siguiente cambio

Para tu primera edición de FLUX 3 Image, elige un cambio fácil de evaluar, nombra los elementos que deban permanecer y revisa el resultado antes de hacer un segundo cambio. Una descripción pequeña y revisable te permite decidir de forma práctica si el resultado sirve para el recurso final.

Referencias

1. Black Forest Labs. Edición con FLUX 3 Image. Consultado el 9 de octubre de 2026 en docs.bfl.ai/flux_3/flux3_image_layout.
2. Black Forest Labs. Recuadros delimitadores con FLUX 3 Image. Consultado el 9 de octubre de 2026 en docs.bfl.ai/flux_3/flux3_image_bounding_boxes.
3. Black Forest Labs. Descripción general de FLUX 3 Image. Consultado el 9 de octubre de 2026 en docs.bfl.ai/flux_3/flux3_image_overview.
4. Black Forest Labs. FLUX 3 Image. Consultado el 9 de octubre de 2026 en bfl.ai/models/flux-3-image.