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

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.

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
• 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
• 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, límites de edición

Elija entre la interfaz web y la API

La página del producto 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 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. 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, precios y configuración

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

Decida cuánto de la imagen quiere especificar

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

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

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

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:

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

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:

{
  "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

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:

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, esquema de filas de edición

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

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

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

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

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

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: 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: 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: proporciona los parámetros, los límites de las referencias, las opciones de resolución y el comportamiento de grounding.
• Tutorial sobre recuadros delimitadores: explica los dos esquemas de filas y el ejemplo de la silueta corriendo adaptado arriba.
• Guía de edición: 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: documenta la autenticación, la recuperación asíncrona, los enlaces que caducan y los errores.
• Precios: 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.