AI-translated from English; not yet reviewed by a fluent editor.

# FLUX 3 Image: guía de recuadros de composición y ediciones específicas

> Use los recuadros de composición y las imágenes de referencia de FLUX 3 Image para crear composiciones o editar partes concretas. Guía basada en documentación sobre coordenadas, recuperación, precios y límites.

By BIG CHANGE Editorial

Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide

![Conceptual charcoal illustration of one right hand placing a flat runner cutout on an orange square art backing.](https://bigchange.ai/api/media/file/flux-layout-collage-hero-v1.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

FLUX 3 Image permite indicar dónde debe ir cada elemento mediante rectángulos incluidos en el prompt de imagen. El mismo sistema admite editar una imagen de referencia: cada elemento puede tener una posición de origen, un destino y una descripción del cambio solicitado. Black Forest Labs añadió el endpoint de generación de imágenes a sus [notas de la versión del 1 de octubre de 2026](https://docs.bfl.ai/release-notes).

Para diseñadores y creadores, la diferencia útil está entre planificar una composición completa y cambiar un elemento de una imagen existente. Esta guía explica cómo elegir entre ambas opciones, convertir un rectángulo en las coordenadas requeridas y recuperar el resultado de una API. Es una guía basada solo en documentación, revisada el 3 de octubre de 2026. BIG CHANGE no generó ni editó imágenes con este producto.

## El gran cambio

- **Qué cambia:** BFL documenta en su versión del 1 de octubre la composición y la edición mediante `v1/flux-3-image`. Una descripción de la escena y una tabla JSON de elementos forman un solo prompt; los recuadros especifican posiciones o ediciones. [notas de la versión de BFL](https://docs.bfl.ai/release-notes)
- **Por qué importa:** Los creadores pueden convertir un recuadro planificado en coordenadas y luego indicar qué elementos de referencia conservar, mover o reemplazar. La decisión práctica es cuánto definir: una composición completa, una instrucción sencilla o una tabla de edición explícita. [tutorial de recuadros de BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **Qué conviene vigilar:** Elija la resolución y el presupuesto antes de enviar la solicitud: los precios publicados para `1k` y `4k` son $0,048 y $0,607 por imagen. Revise el resultado completo: los elementos pueden salirse de los recuadros y una edición puede alterar la iluminación, las sombras o los reflejos cercanos. [precios de BFL](https://docs.bfl.ai/quick_start/pricing), [límites de edición](https://docs.bfl.ai/flux_3/flux3_image_layout)

## Elija entre la interfaz web y la API

La [página del producto](https://bfl.ai/models/flux-3-image) de BFL describe dos formas de empezar: dibujar recuadros en su Playground web o enviar un prompt de composición a través de la API. La [documentación enlaza al Playground](https://playground.bfl.ai) para usarlo sin código. Use la interfaz web si quiere dibujar las regiones directamente; use la API si necesita incluir coordenadas en una solicitud y recuperar el resultado mediante código. No hemos inspeccionado los controles actuales del Playground, así que las instrucciones siguientes describen el formato documentado de la solicitud, no una secuencia de botones.

Para usar la API, cree una cuenta de BFL, añada créditos y obtenga una clave en el [panel de control](https://dashboard.bfl.ai). Envíe un objeto JSON mediante `POST` a `https://api.bfl.ai/v1/flux-3-image`, usando `Content-Type: application/json` y la clave en el encabezado `x-key`. Solo se requiere `prompt`. [guía de generación de BFL](https://docs.bfl.ai/flux_3/flux3_image_generate), [precios y configuración](https://docs.bfl.ai/quick_start/pricing)

No confunda FLUX 3 Image con FLUX 3 Dev: estas instrucciones se refieren al endpoint Image alojado por BFL. La página del producto Image ofrece una licencia comercial de pesos a través del equipo de ventas. Las fuentes consultadas para esta guía no confirman que FLUX 3 Image se pueda descargar con pesos abiertos. [acceso a FLUX 3 Image](https://bfl.ai/models/flux-3-image)

## Decida cuánto de la imagen quiere especificar

| Tarea | Entrada documentada | Control que debe usar |
| --- | --- | --- |
| Generar una composición nueva | Un prompt de escena, seguido opcionalmente de una tabla de elementos | `bbox` para cada elemento cuya ubicación sea importante |
| Cambiar un detalle identificable | Una instrucción y una imagen de referencia | Puede bastar con una descripción precisa; inspeccione el prompt ampliado |
| Elegir exactamente qué elementos editar | Una instrucción, una imagen de referencia y una tabla de edición | Recuadros de origen y destino, con filas de conservación para los elementos que deben permanecer |
| Combinar referencias | Un prompt que explique la función de cada imagen y entre 2 y 10 imágenes | Identificar qué imagen aporta cada sujeto, objeto o entorno |

BFL indica que, al ampliar el prompt, se puede asignar automáticamente un recuadro a una edición sencilla. Para un control explícito, proporcione su propia tabla. En las instrucciones normales, «imagen 1» significa la primera referencia; en las filas de edición, esa misma referencia es `ref_image_0`. [guía de edición de BFL](https://docs.bfl.ai/flux_3/flux3_image_layout)

Las referencias se incluyen en `images` como URL o datos en base64, en forma de cadena o lista. Se pueden proporcionar de 1 a 10; cada una debe medir al menos 256 × 256 píxeles y no superar los 16 megapíxeles. El valor predeterminado de `aspect_ratio` es `auto`: sigue la proporción de la primera referencia o produce un cuadrado si no se proporciona ninguna. Indíquelo explícitamente si la composición necesita una forma concreta. [descripción general del endpoint de BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)

## Convierta un rectángulo en un recuadro

Cada recuadro se expresa como `[top, left, bottom, right]`, con coordenadas enteras de 0 a 1000. Primero se indican las coordenadas verticales. Cada eje abarca toda la imagen por separado, por lo que la cuadrícula se adapta tanto a un lienzo apaisado como a uno vertical. [formato de recuadros de BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

Para convertir posiciones en píxeles, divida las coordenadas superior e inferior por la altura de la imagen, y las coordenadas izquierda y derecha por su anchura. Multiplique cada resultado por 1000 y redondee. La conversión documentada por BFL usa un lienzo de 1920 × 1080:

| Borde | Posición en píxeles | Cálculo | Valor en la cuadrícula |
| --- | --- | --- | --- |
| Superior | 108 | 108 ÷ 1080 × 1000 | 100 |
| Izquierdo | 384 | 384 ÷ 1920 × 1000 | 200 |
| Inferior | 972 | 972 ÷ 1080 × 1000 | 900 |
| Derecho | 1536 | 1536 ÷ 1920 × 1000 | 800 |

Por tanto, el recuadro es `[100, 200, 900, 800]`. Su extensión vertical va del 10 % al 90 % del encuadre y la horizontal, del 20 % al 80 %. Este cálculo explica por qué intercambiar la anchura y la altura, o indicar primero la coordenada izquierda en vez de la superior, cambia la región prevista. Mantenga la proporción usada para diseñar la composición. [conversión de coordenadas de BFL](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## Componga una imagen nueva

Describa la composición completa y nombre los elementos con `<id>` como marcadores. Añada un array JSON con los campos `id`, `bbox` y `desc` para cada elemento. El array forma parte del texto de `prompt`, no es otro campo de nivel superior de la API.

El ejemplo documentado por BFL de una silueta corriendo muestra un fondo que ocupa todo el lienzo y una figura en el recuadro central. Esta solicitud abreviada sigue esa composición; BIG CHANGE no la ha ejecutado:

```json
{
  "prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
  "aspect_ratio": "1:1",
  "resolution": "1k"
}
```

Para una composición con texto, ponga cada línea en su propia fila e incluya las palabras exactas solicitadas en `desc`. Los recuadros orientan la posición y la escala; BFL advierte que un elemento puede sobresalir de su rectángulo. No son máscaras de recorte estrictas. [tutorial de composición y límites de BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## Edite una imagen existente

Incluya la imagen de origen en `images`. Las filas de edición conservan `id` y `desc`, pero sustituyen `bbox` por estos campos:

| Operación | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Conservar un elemento | `"ref_image_0"` | Su recuadro de origen | El mismo recuadro |
| Moverlo o cambiar su tamaño | `"ref_image_0"` | Su recuadro de origen | Un recuadro de destino diferente |
| Añadir, reemplazar o cambiar el color | `null` | `null` | El recuadro de destino deseado |
| Eliminarlo | `"ref_image_0"` | Su recuadro de origen | `null` |

Combine la instrucción y el array de edición en `prompt`, igual que en una composición nueva. Describa las adiciones y eliminaciones en ambos lugares. Añada filas de conservación para los elementos que deben permanecer en su sitio. Según la guía de BFL, los píxeles fuera de los recuadros suelen mantenerse iguales, pero la iluminación, los reflejos y las sombras cercanos pueden cambiar. Compare todo el resultado con la imagen de origen antes de aceptar la edición. BFL también indica que, en sus pruebas, muchos elementos nuevos en recuadros de unos 40 × 25 píxeles no aparecieron; es una observación del proveedor, no un mínimo universal ni una prueba de BIG CHANGE. [guía de edición de BFL](https://docs.bfl.ai/flux_3/flux3_image_layout), [esquema de filas de edición](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## Elija la resolución y el presupuesto

La descripción general enumera `768sq`, `1k`, `1.5k`, `2k` y `4k`, con `1k` como valor predeterminado. La página de precios publica las siguientes tarifas; no indica el precio de `1.5k`. Compruebe el costo de esa opción antes de usarla. [descripción general de BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)

| Resolución | Tamaño de salida documentado | Precio por imagen | Diez solicitudes, cálculo aritmético |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0,041 | $0,41 |
| `1k` | Aproximadamente 1 megapíxel | $0,048 | $0,48 |
| `2k` | Aproximadamente 4 megapíxeles | $0,100 | $1,00 |
| `4k` | Aproximadamente 16 megapíxeles | $0,607 | $6,07 |

Estos son los precios en dólares estadounidenses publicados por BFL, consultados el 3 de octubre. La columna de diez solicitudes es un cálculo, no un gasto medido. BFL indica el mismo precio para la API y Playground; un crédito equivale a $0,01. La respuesta a la solicitud incluye `cost`. Una solicitud en `4k` cuesta aproximadamente 12,6 veces el precio indicado para `1k`; elija el tamaño de salida que requiera la tarea y prevea presupuesto para intentos adicionales. Cambiar la resolución supone una solicitud nueva, y esta guía no establece que dos solicitudes produzcan la misma composición. [precios de BFL](https://docs.bfl.ai/quick_start/pricing)

El ajuste opcional de `grounding` está activado por defecto con el valor `true`, lo que habilita búsquedas web y de imágenes antes de generar. BFL afirma que desactivarlo produce resultados más rápido usando solo el prompt. No medimos esa diferencia de velocidad ni verificamos la precisión de los resultados fundamentados en búsquedas. [documentación de grounding de BFL](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## Envíe la solicitud, consulte el estado y guarde el resultado

Después de enviar la solicitud, conserve la URL de consulta de estado `polling_url` y consulte esa misma URL con su clave de API. Apunta a la región donde se procesa la tarea. `Pending`, `Reasoning` y `Generating` indican que la tarea sigue en curso. Cuando aparezca `Ready`, descargue `result.sample`; su enlace firmado caduca al cabo de una hora. No envíe el encabezado `x-key` a la URL de descarga. El resultado también contiene `result.prompt`, que muestra la instrucción ampliada, y `result.duration`, que indica el tiempo de generación. [instrucciones de recuperación de BFL](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

Una tarea bloqueada o fallida requiere una respuesta distinta a la de una tarea en curso. `Request Moderated` indica que se bloqueó la entrada; `Content Moderated` indica que se bloqueó la salida. Ajuste la entrada antes de volver a intentarlo. Para `Error`, revise la respuesta; una tarea desconocida o caducada devuelve `Task not found`. BFL advierte que una tarea fallida puede responder con HTTP `503` y un cuerpo JSON normal, así que compruebe su `status` antes de reintentar. Las referencias demasiado grandes producen `400`; un campo desconocido, un valor no válido, un prompt en blanco o una imagen demasiado pequeña pueden producir `422`. En este endpoint no se aceptan campos como `seed`, `width` y `input_image` de otros endpoints. [guía de generación y errores de BFL](https://docs.bfl.ai/flux_3/flux3_image_generate)

El intento concluye cuando ha guardado el resultado y ha inspeccionado la ubicación de los elementos, cualquier texto solicitado y las zonas cercanas a una edición. Una respuesta `Ready` confirma que hay un resultado disponible; la revisión visual determina si cumple la tarea.

## Fuentes y lecturas adicionales

- [Página del producto FLUX 3 Image](https://bfl.ai/models/flux-3-image): describe las opciones de navegador y API y el acceso a una licencia comercial de pesos. Sus demostraciones son material del proveedor, no resultados de nuestras pruebas.
- [Notas de la versión del 1 de octubre](https://docs.bfl.ai/release-notes): fecha el lanzamiento de Image y describe el endpoint compartido. Las afirmaciones generales sobre control se leen junto con las limitaciones más específicas de los tutoriales.
- [Descripción general del endpoint](https://docs.bfl.ai/flux_3/flux3_image_overview): proporciona los parámetros, los límites de las referencias, las opciones de resolución y el comportamiento de grounding.
- [Tutorial sobre recuadros delimitadores](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes): explica los dos esquemas de filas y el ejemplo de la silueta corriendo adaptado arriba.
- [Guía de edición](https://docs.bfl.ai/flux_3/flux3_image_layout): respalda la conversión de coordenadas, el orden de las referencias y las salvedades sobre regiones pequeñas y píxeles cercanos.
- [Guía de generación](https://docs.bfl.ai/flux_3/flux3_image_generate): documenta la autenticación, la recuperación asíncrona, los enlaces que caducan y los errores.
- [Precios](https://docs.bfl.ai/quick_start/pricing): proporciona las tarifas usadas en nuestros cálculos. Vuelva a comprobar los precios y los parámetros de la solicitud antes de pagar un intento; estos documentos pueden cambiar.

## Sources

- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — Describe las opciones de navegador y API y el acceso a una licencia comercial de pesos. Sus demostraciones son material del proveedor, no resultados de nuestras pruebas. Las fuentes consultadas no confirman que se puedan descargar los pesos de este endpoint Image.
- [Descripción general de FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_overview) — Proporciona los parámetros, los límites de las referencias, las opciones de resolución y el comportamiento de grounding.
- [Composición y edición con recuadros de FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_layout) — Explica la conversión de coordenadas y el orden de las referencias, y las salvedades sobre las regiones pequeñas y los píxeles cercanos.
- [Generación con FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_generate) — Documenta la autenticación, la recuperación asíncrona, los enlaces que caducan y los errores.
- [Notas de la versión](https://docs.bfl.ai/release-notes) — Fecha el lanzamiento de Image y describe el endpoint compartido. Las afirmaciones generales sobre control se leen junto con las limitaciones más específicas de los tutoriales.
- [Precios](https://docs.bfl.ai/quick_start/pricing) — Proporciona las tarifas usadas en nuestros cálculos. Vuelva a comprobar los precios y los parámetros de la solicitud antes de pagar un intento; estos documentos pueden cambiar.
- [Recuadros delimitadores de FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — Explica los dos esquemas de filas y el ejemplo de la silueta corriendo adaptado arriba.