Black Forest Labs: FLUX.2 Max
FLUX.2 [max] es el modelo de imágenes de Black Forest Labs para recursos finales exigentes y ediciones coherentes. Su perfil documentado combina referencias visuales, control detallado de la escena y fundamentación mediante la web para temas actuales, con resultados de hasta 4 megapíxeles.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
FLUX.2 [max] es el miembro de máxima calidad de la familia de generación y edición de imágenes FLUX.2 de Black Forest Labs. El fabricante lo orienta a recursos finales exigentes, un seguimiento sólido de encargos complejos y coherencia entre ediciones. Crea una imagen a partir de una descripción escrita o utiliza imágenes proporcionadas como referencias visuales. Su capacidad distintiva dentro de la familia es la búsqueda para fundamentar la generación: una solicitud puede recurrir a información actual en lugar de depender únicamente de la escena descrita en el prompt.
Información del mundo real y encargo visual
El fabricante documenta la búsqueda web para temas como el clima actual, un evento deportivo reciente o un entorno histórico. Identifica el lugar, el evento y el momento reales relevantes para la imagen y describe el tratamiento artístico por separado. Un concepto de tarjeta meteorológica fundamentado podría especificar la ciudad, qué condición visualizar, el título exacto y la distribución. La búsqueda informa la generación; aun así, una ilustración atractiva necesita que sus datos visibles se contrasten con la fuente pertinente antes de convertirse en una comunicación factual.
Esta capacidad de búsqueda pertenece a [max] en la comparación publicada de FLUX.2. Los demás miembros tienen sus propias funciones: [pro] para producción, [flex] para muestreo ajustable y tipografía, y [klein] para generación interactiva compacta. Conserva el nombre del modelo seleccionado junto con el resultado para que una revisión posterior no sustituya silenciosamente el perfil que admite fundamentación por otra edición.
Referencias para ediciones exigentes
El perfil documentado de solicitudes admite hasta ocho imágenes de referencia; la interfaz interactiva del fabricante permite diez por separado. Asigna una función a cada referencia, como el aspecto del personaje, el diseño del producto, la ropa, la habitación o el estilo visual. Una composición puede combinar la silla de una imagen con la habitación de otra y mantener la silueta y el material de la silla. Para una escena existente, identifica el objeto que debe cambiar y los detalles que deben conservarse, incluida la dirección de la luz y la geometría circundante.
Los ejemplos de la familia incluyen cambios de fondo, sustitución de objetos, composiciones de muebles, ediciones de texto y personajes coherentes. Un encargo original para un recurso final podría colocar un reloj proporcionado sobre una tela oscura doblada, mantener el diseño de la esfera y la correa y cambiar únicamente la iluminación por una luz lateral suave. Indica qué fuente aporta cada característica y revisa conjuntamente la esfera, las marcas, el material y los reflejos resultantes. Una instrucción de conservación establece el objetivo; la imagen devuelta es la evidencia con la que compararlo.
Texto, colores e interpretación del prompt
La guía de FLUX.2 recomienda una estructura de sujeto, acción, estilo y contexto, con los elementos importantes al principio. Sugiere entre 10 y 30 palabras para conceptos rápidos, entre 30 y 80 para proyectos habituales y descripciones más largas para escenas complejas. Son recomendaciones de redacción, no límites estrictos de contexto. Tanto el lenguaje natural como las descripciones de escena estructuradas en JSON son formas documentadas de organizar sujetos, ubicación, luz y estilo. Un prompt estructurado es un encargo de imagen, no una promesa de respuesta textual estructurada.
Para las letras visibles, cita el texto, especifica su posición y describe la jerarquía tipográfica. Vincula cada color hexadecimal a un objeto o elemento de texto concreto; un código de color sin un destino identificado es ambiguo. La guía del fabricante utiliza descripciones positivas en lugar de un mecanismo de prompts negativos. Para una escena de producto con espacio vacío para un titular, describe directamente esa zona vacía y su ubicación prevista.
La especificación exacta de solicitudes de [max] aplica la ampliación del prompt de forma predeterminada. El control disable_pup la desactiva cuando conviene utilizar un encargo cuidadosamente redactado tal como se ha proporcionado. Esto es distinto de afirmar que cada palabra aparecerá sin cambios en la imagen final. Conserva el encargo real y el ajuste seleccionado junto con el resultado al evaluar si una decisión visual inesperada procede de la instrucción o de su interpretación.
Resultado y recurso final útil
La guía de la familia documenta imágenes de hasta 4 megapíxeles, con dimensiones explícitas de al menos 64×64 y múltiplos de 16. Su recomendación para el uso habitual es de hasta 2 megapíxeles. El perfil exacto de [max] enumera JPEG, PNG y WebP, con JPEG como predeterminado, y una semilla aleatoria opcional. Elige la forma del resultado para su ubicación prevista antes de organizar la composición. La generación de imágenes del modelo es distinta de redimensionar un recurso ya terminado.
Conserva la imagen, las referencias, el prompt, las dimensiones y la identidad del modelo al seleccionar la versión final. La guía FLUX.2 del productor advierte de que el enlace firmado del resultado es temporal, con un plazo de recuperación de diez minutos. Revisa el texto pequeño, la identidad de los objetos, la distribución, la luz y los datos obtenidos mediante búsqueda al tamaño de visualización previsto. El recurso útil es la imagen elegida con contexto suficiente para continuar una revisión exacta, en lugar de una escena cuyos detalles importantes nunca se han comparado con el encargo.
Ailoot Ultra · Imágenes POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxPrimeros pasos
FLUX.2 [max] es el modelo de imágenes de Black Forest Labs para recursos finales exigentes y ediciones coherentes. Su perfil documentado combina referencias visuales, control detallado de la escena y fundamentación mediante la web para temas actuales, con resultados de hasta 4 megapíxeles.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Imágenes POST /v1/images/generations
- Tipos de entrada
text,image- Tipos de salida
image
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites black-forest-labs/flux.2-max | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predeterminado— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores y límites png, jpeg | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 1 | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 0 Número máximo de elementos: 8 | Predeterminado— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetromaterial_types | Contratotext, image |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id real devuelto o registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| Configuraciónmegapíxel de imagen de salida | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor megapíxel de imagen de salida | Cargo Salida · megapíxel de imagen de salida · Estimación solo para comparar $0.14 por megapíxel de imagen de salida |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.14 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Imágenes
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-max', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Recibir y guardar resultados
Ailoot Ultra · Imágenes
Descarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Otras consultas de contenido
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserva todos los resultados completados
Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Si es necesario revisar la respuesta original
Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Alias
Alias del modelo
Ailoot Ultra black-forest-labs/flux.2-max
Alias de rutas de métodos
/v1/images
ID de modelo relacionados
FAQ · Black Forest Labs: FLUX.2 Max
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- ¿Qué límites se aplican?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1