Construye con CometAPI¿Necesitas una sola API para varios modelos?Prueba el flujo en el Playground y luego crea una clave de API cuando el modelo y el costo encajen con tu caso de uso.
Utilice FLUX 3 Image en CometAPI para la generación y la edición. Aprenda sobre los parámetros de imagen, la gestión asíncrona de trabajos, ejemplos de prompts y tarifas.
Deon GoodwinEquipo de investigación de modelos de IA y API
Crea fotografías de producto, carteles y ediciones basadas en referencias con FLUX 3 Image, disponible a través de CometAPI como flux-3-image, con precios desde $0.0384 por solicitud. Esta guía te lleva por la elección de ajustes de imagen, la preparación de una solicitud, el manejo de un trabajo asíncrono y la revisión de la imagen final. Necesitarás una cuenta de CometAPI, una clave de API y la configuración de solicitud de FLUX 3 Image suministrada para tu cuenta.
Puntos clave
Elige texto-a-imagen para composiciones nuevas y edición guiada por referencias cuando un producto o sujeto deba permanecer reconocible.
Usa un borrador pequeño para revisar la composición antes de gastar en una imagen final más grande.
Utiliza credenciales de CometAPI y su esquema de solicitud específico del modelo; las claves y ejemplos nativos de BFL pertenecen a una integración separada.
Revisado para mayor claridad, atribución de fuentes y terminología API actual.
Estima costos con la tarifa aplicable de CometAPI y luego mide el gasto por entregable aceptado.
Completa un ciclo de envío, obtención de resultados, descarga y revisión visual antes de ejecutar un lote.
¿Qué es la API FLUX 3 Image?
FLUX 3 Image es el modelo de Black Forest Labs para crear y revisar imágenes fijas. Un prompt de texto describe una escena nueva; las imágenes de referencia aportan material visual que se debe preservar, combinar o cambiar. Para un equipo de comercio electrónico, esto puede significar desarrollar una escena de producto a partir de un brief y luego reutilizar una foto de producto aprobada mientras se cambian los alrededores.
Elige un flujo de trabajo antes de redactar el prompt. Para un visual nuevo, especifica el sujeto, el entorno, la iluminación y el encuadre. Para una edición, identifica la imagen fuente, nombra el cambio y señala qué detalles deben permanecer intactos. Para una composición con varias referencias, asigna a cada una un rol para que la identidad del producto y el estilo visual no compitan.
Especificaciones de FLUX 3 Image y parámetros de la API
Planifica tu imagen con los siguientes ajustes. Los controles del modelo siguen la referencia de la API BFL FLUX 3 Image; la autenticación y el enrutamiento de solicitudes siguen tu integración con CometAPI. Usa los nombres de campo aceptados por tu ruta FLUX 3 Image de CometAPI.
Capacidad / configuración
Qué controla
Cómo usarlo con CometAPI
Identidad del modelo
FLUX 3 Image; ID de catálogo flux-3-image
Usa la ruta específica del modelo y la convención de enrutamiento del ejemplo de tu cuenta.
Generación / prompt
La escena, composición o instrucción de edición
Comienza con un sujeto claro y un resultado previsto.
Imágenes de referencia / native images
Una lista ordenada de 1–10 imágenes de referencia, suministradas como URLs HTTP(S) o base64 en la API nativa
Confirma el nombre del campo de la pasarela, el formato de entrada y el límite de referencias.
Relación de aspecto / native aspect_ratio
Las proporciones del lienzo. Con auto, una relación solicitada en el prompt tiene prioridad; de lo contrario, las ediciones mantienen el encuadre de la primera referencia.
Elige una relación para el formato de entrega y confirma los valores aceptados.
Resolución / native resolution
Niveles nativos: 768sq, 1k (predeterminado), 1.5k, 2k y 4k. Las dimensiones exactas dependen de la relación de aspecto.
Para ediciones, match_input preserva el tamaño de la primera referencia, reducido a 4 MP si es mayor; una aspect_ratio explícita selecciona su nivel más cercano. width y height explícitos tienen prioridad.
Dimensiones exactas / width + height
Proporciona ambos enteros, cada uno entre 256–6256 píxeles. Anulan resolution y aspect_ratio. El área total está limitada a 16,822,272 píxeles, o 4,194,304 píxeles cuando se usan referencias.
Usa dimensiones explícitas para un tamaño de entrega fijo, como 1024 × 1280. Confirma que tu ruta de CometAPI acepte estos controles nativos.
Control de diseño
Guía de colocación de elementos mediante cajas delimitadoras
Usa la sintaxis de diseño documentada cuando la colocación exacta sea importante.
Elige dimensiones de una de tres maneras: un nivel de resolución más relación de aspecto, width más height para un lienzo exacto, o match_input para una edición. Mantén disponible la referencia original para comparar encuadre y detalle después de la generación. El endpoint nativo rechaza campos no compatibles; usa el esquema de la ruta que estés llamando.
Composición de imagen detallada y ediciones que preservan píxeles
Compara los mismos prompts de marca
Resolución
Generación de alta resolución dependiente de la variante
Muestra nativa explícita 2K/4K
Inspecciona detalles finos al máximo zoom
Edición
Capacidades multirreferencia en variantes selectas
Demostraciones de edición localizada
Mide la desviación en áreas no editadas
Costo
Varía según la variante y la plataforma
Tarificación de CometAPI para la configuración seleccionada
Compara por imagen aceptada
Acceso CometAPI
Disponible en CometAPI como FLUX 2 PRO y FLUX 2 MAX
Disponible en CometAPI como flux-3-image
Valida la solicitud específica del modelo antes de cambiar el enrutamiento en producción
Evaluación
Usa la variante exacta desplegada hoy
Ejecuta el mismo prompt y conjunto de referencias
Compara salidas aceptadas y costo total del flujo de trabajo
Mantén tu integración actual de FLUX.2 como línea base de comparación mientras evalúas FLUX 3 Image. Ejecuta los mismos briefs y activos de referencia en ambos flujos de trabajo, luego compara salidas aceptadas, tiempo de respuesta y costo total.
¿Cómo generar una imagen con la API FLUX 3 Image en CometAPI?
POST https://api.cometapi.com/flux/v1/flux-3-image
La autenticación usa un token Bearer (estilo CometAPI). Las solicitudes son asíncronas por defecto.
3. Ejemplo básico texto-a-imagen (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Consulta hasta que status sea "Ready". La URL de la imagen aparece en result.sample (descárgala de inmediato; las URLs firmadas son temporales).
Para una espera sincrónica en la misma solicitud, agrega "async": false al cuerpo (mantén la conexión abierta; usa un tiempo de espera generoso en el cliente).
5. Ejemplo en Python (enviar + consultar)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image admite tanto texto-a-imagen puro como edición/multirreferencia en el mismo endpoint: basta con incluir images y describir cómo usarlas en el prompt (no hay un campo “mode” separado).
Alternativa: ruta compatible con OpenAI
También puedes probar el endpoint unificado de imágenes con el ID del modelo:
POST https://api.cometapi.com/v1/images/generations
(Se prefiere la ruta nativa `/flux/v1/...` para parámetros completos de FLUX 3.)
### Consejos
* Revisa la disponibilidad actual y el precio exacto en la [página del modelo Flux 3 Image de CometAPI](https://www.cometapi.com/models/flux/flux-3-image/).
* Descarga siempre la URL `result.sample` rápidamente.
* Para la lista de parámetros más reciente o ejemplos del playground, consulta la documentación de Flux de CometAPI y la referencia oficial de FLUX 3 Image de Black Forest Labs.
Esto refleja el flujo oficial de BFL usando la autenticación e infraestructura unificadas de CometAPI.
## ¿Cómo hacer prompt con FLUX 3 Image? Ejemplos
### Ejemplo: Prompt de fotografía de producto
Usa este prompt para una primera prueba de fotografía de producto.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Reemplaza el valor del prompt en request.json con este brief, manteniendo el cuerpo de la solicitud esperado por tu ruta de CometAPI. Un lienzo 4:5 se adapta a una colocación de producto en formato vertical. Si tu ruta acepta controles nativos de dimensión, 1024 × 1280 es una opción exacta 4:5; proporciona ambos valores juntos.
Comienza con un borrador pequeño y revisa la silueta de la botella, la etiqueta, los reflejos y objetos adicionales. Si la identidad exacta del producto importa, usa una referencia de producto en lugar de esperar que un prompt solo de texto la reconstruya. Registra el prompt y los ajustes de salida antes de hacer cambios.
### Ejemplo: Tipografía y diseño de cartel
Prompt para cartel con texto de título especificado explícitamente.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Usa este brief como prompt en tu solicitud de CometAPI y elige un lienzo vertical. Comienza con un borrador para revisar la posición del titular y la disposición de los personajes, luego aumenta el tamaño de salida para la obra final.
Trata la precisión de las letras como una condición de aceptación medible. Revisa cada letra y signo de puntuación en la salida de resolución final; las imágenes impresionantes no garantizan cero errores en el texto de tu marca específica.
## ¿Cómo editar imágenes con referencias?
Para una edición, describe tanto el cambio que deseas como los detalles que se deben preservar. La API nativa FLUX 3 Image toma referencias en images; asígnalas al campo de entrada correspondiente en tu ejemplo de CometAPI. Coloca la referencia del producto primero y mantén ese orden de forma constante en el prompt.
### Edición de una sola imagen: cambiar el fondo y preservar el producto
Mantén edit.py junto a submit.py, poll.py y download.py. Establece PRODUCT\_IMAGE\_URL a una foto de producto accesible públicamente por HTTPS y luego ejecuta python edit.py. El siguiente ejemplo requiere una ruta que acepte la matriz nativa images. Usa un cuerpo de solicitud de edición sin campos de imagen fuente en conflicto y cambia el mapeo si tu ejemplo de CometAPI usa un campo de entrada diferente. Para reanudar una tarea de edición guardada, ejecuta python poll\_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Elige una foto de producto nítida con una etiqueta legible y una silueta clara. Envíala en el formato de entrada de imagen aceptado por tu ruta de CometAPI. Si esa ruta admite la configuración nativa de resolución, usa match\_input para conservar el encuadre y tamaño de la referencia, sujeto a los límites de edición del modelo.
La [galería de BFL](https://bfl.ai/models/flux-3-image) demuestra una edición localizada agregando dos buzos. Estos recursos oficiales de antes y después ilustran qué inspeccionar; no son resultados de una solicitud de CometAPI ejecutada para este artículo.
Ejemplo oficial de edición de BFL, antes: la escena submarina original con un buzo.
Ejemplo oficial de edición de BFL, después: se añaden dos buzos. Inspecciona el fondo sin cambios así como los nuevos sujetos.
### Edición con múltiples imágenes de referencia: combinar estilo e identidad de producto
Mantén el producto primero y la referencia de iluminación/estilo segunda. Establece PRODUCT\_IMAGE\_URL y STYLE\_IMAGE\_URL, guarda el código siguiente como multi\_edit.py junto a los tres archivos del cliente y ejecuta python multi\_edit.py. Este ejemplo requiere una ruta que acepte al menos dos referencias en images. Comienza con un cuerpo de solicitud de edición sin campos de imagen fuente en conflicto. Reanuda un trabajo guardado con python poll\_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Adjunta ambas referencias usando el formato específico del modelo en CometAPI. Primero revisa si el producto conservó su identidad; luego evalúa si la segunda referencia aportó la luz y el color previstos. Si también introduce objetos o letras no deseadas, simplifica esa referencia o haz el prompt más explícito.
## ¿Cómo usar cajas delimitadoras para control de diseño?
Usa cajas cuando la botella y el titular deban ocupar regiones predecibles. Escribe una leyenda de escena con un ID para cada elemento y luego agrega una matriz JSON al prompt. El formato de BFL usa bbox en orden [top, left, bottom, right] en una cuadrícula de 0–1000; las cajas van dentro del prompt, no en un campo separado de la API.
El ejemplo a continuación reserva espacio para un titular sobre la botella. Mantén un ajuste de salida vertical en request.json y guarda este archivo como layout.py junto a submit.py. Ejecuta python layout.py y luego python poll\_download.py layout-task.json. Usa una ruta que admita esta sintaxis de diseño; inspecciona el resultado para verificar si la botella y el titular ocupan las regiones previstas.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Mantén la relación de aspecto coherente con el diseño. Las cajas guían la colocación en vez de recortar un objeto a un límite rígido. Inspecciona la ortografía y el espaciado del titular en la imagen guardada; añade la rotulación final de marca en una herramienta de diseño cuando la tipografía exacta sea esencial.
## ¿Cuánto cuesta la API FLUX 3 Image?
CometAPI ofrece FLUX 3 Image desde [$0.0384 por solicitud](https://www.cometapi.com/models/flux/flux-3-image/) (9 de noviembre de 2026). Usa esta tarifa inicial para un presupuesto preliminar y luego aplica la tarifa mostrada para tu configuración seleccionada. Los ejemplos a continuación asumen que cada solicitud facturada usa la tarifa inicial.
| Solicitudes facturadas | Tarifa asumida / solicitud | Costo ilustrativo |
| ---------------------- | -------------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Verifica la tarifa de tu configuración y cuenta antes de comprometer un lote. El precio público inicial no establece el precio de cada opción de resolución o edición. Rastrea los intentos creativos rechazados así como las salidas aprobadas: si gastas $3.84 en 100 solicitudes facturadas y apruebas 80 entregables, el costo de API por entregable aceptado es $0.048, antes de la revisión humana y el almacenamiento. Este es un cálculo ilustrativo, no una tasa de aceptación medida.
### Elecciones de resolución por flujo de trabajo
| Flujo de trabajo | Primera prueba | Verificación de aprobación |
| --------------------------------| ------------------------------------------------ | -------------------------------------------------- |
| Exploración de prompts | Nivel más pequeño útil admitido | Composición y colocación del sujeto |
| Imágenes de producto e-commerce | Un borrador con el recorte previsto | Geometría del producto, etiquetas y detalle de bordes |
| Arte de campaña o editorial | Borrador primero; salida mayor tras aprobar el diseño | Tipografía y detalle al tamaño de entrega |
| Ediciones basadas en referencia | Un ajuste compatible adecuado para la fuente | Regiones sin cambios, identidad del producto e iluminación |
## ¿Cuándo deberías usar FLUX 3 Video?
Usa FLUX 3 Image para activos fijos como una imagen hero de producto, un cartel o un cuadro de campaña. Si el entregable necesita movimiento, consulta [FLUX 3 Video en CometAPI](https://www.cometapi.com/models/flux/flux-3/), listado bajo el ID de modelo flux-3. Su [flujo de video](https://apidoc.cometapi.com/api/video/flux-3/create) usa ajustes y facturación específicos de video. Mantén separadas las solicitudes de imagen y video; la duración, el audio y los controles de fotogramas de video no pertenecen a una solicitud de imagen fija.
Para una campaña con ambos formatos, aprueba primero la composición de la imagen fija y luego prepara el brief de movimiento por separado. Revisa los requisitos de entrada de referencia del modelo de video antes de reutilizar una imagen aprobada como material fuente.
## Conclusión
Comienza con un brief de producto y un trabajo de imagen pequeño. Envíalo a través de tu ruta FLUX 3 Image de CometAPI, guarda el ID de tarea, recupera la imagen completada y revisa el resultado antes de escalar. Usa width y height cuando necesites un lienzo exacto, o match\_input para una edición con referencia donde esté admitido. Compara el gasto total con el número de imágenes que apruebas para que tu presupuesto refleje resultados utilizables.
## Metadatos SEO
Meta title: Guía de la API FLUX 3 Image: Generación, Edición y CometAPI
Meta description: Usa FLUX 3 Image en CometAPI para generación y edición. Aprende parámetros de imagen, manejo de trabajos asíncronos, ejemplos de prompt y precios desde $0.0384 por solicitud.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 edición de imagen, FLUX 3 pricing, generación con imágenes de referencia, migración FLUX.2
URL slug: flux-3-image-api-guide
Ediciones dirigidas
Cambios en sujetos o regiones seleccionadas
Compara la fuente y el resultado en áreas que deberían permanecer sin cambios.
Autenticación
Clave de API de CometAPI para solicitudes a la pasarela
Sigue los encabezados de autenticación del ejemplo de CometAPI; mantiene la clave en el servidor.
Manejo de resultados
Generación asíncrona: envía un trabajo, rastrea su ID de tarea y recupera la imagen terminada.
Usa la plantilla de Python a continuación cuando la ruta de tu cuenta siga el contrato de tareas de CometAPI para FLUX.
Precios
La tarificación de CometAPI comienza en $0.0384 por solicitud (9 de noviembre de 2026).
Usa la sección de precios debajo como presupuesto ilustrativo; verifica la configuración seleccionada.
Campos extra
Los esquemas nativo y de pasarela difieren entre generaciones de modelos
FLUX 3 Image nativo acepta width y height. No reutilices seed o input_image de un modelo anterior; usa images para entradas de referencia nativas y sigue el esquema de la pasarela en CometAPI.
