API de edición de FLUX.2 Max: fotos con varias referencias

Name: FLUX.2 Max API
SKU: black-forest-labs/flux-2-max/edit
Price: 0.12 USD
Availability: InStock

Parámetros de la petición

Parámetro	Obligatorio	Descripción
`aspect_ratio`	No	La forma del encuadre: horizontal, cuadrado o vertical. auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Por defecto: auto
`image_urls`	Sí	Fotos para editar o combinar. Di en el prompt qué aporta cada una.
`prompt`	Sí	Say what to change and what must stay the same.
`resolution`	No	Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · Por defecto: 1k
`seed`	No	Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

Opción	Créditos por imagen	≈ USD
Estándar	11,42	0,11 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 12 créditos por imagen (0,12 US$).

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de FLUX.2 Max en tres pasos

Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
Envía la solicitud. Haz POST /jobs/createTask con model black-forest-labs/flux-2-max/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "black-forest-labs/flux-2-max/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "resolution": "1k"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de FLUX.2 Max

¿Cuánto cuesta la API de FLUX.2 Max?

FLUX.2 Max cuesta desde 12 créditos (0,12 US$) por imagen con Editar imagen, su tarea más barata. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de FLUX.2 Max en la API?

Pon black-forest-labs/flux-2-max/text-to-image para Crear imagen; black-forest-labs/flux-2-max/edit para Editar imagen en el campo model de POST /jobs/createTask.

¿Qué es FLUX.2 [max]?

Es el modelo de mayor calidad de la familia FLUX.2 de Black Forest Labs, lanzado el 16 de diciembre de 2025. Está pensado para personas y luz fotorrealistas, texto legible en la imagen y ediciones que combinan varias referencias.

¿Puede escribir texto dentro de las imágenes?

Sí. Nuestro ejemplo de portada de revista generó un título, una línea de portada y una línea de número, todos escritos tal como se pidieron. Pon cada línea entre comillas e indica dónde va. Los valores de color hex del prompt se siguen de cerca.

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

De una a tres. En el prompt, llámalas imagen 1, imagen 2 e imagen 3 e indica qué aporta cada una. Nuestro ejemplo de la librería colocó a dos mujeres de retratos distintos en una tercera foto de un espacio.

¿Qué hace auto en las ediciones?

Con auto, el resultado conserva la forma de la primera imagen de origen con cerca de un megapíxel. Si eliges una relación de aspecto, puedes escoger 1k o 2k.

¿Busca en la web o admite ajustes de pasos y guidance?

No. Aquí no se ofrecen esos controles. Dispones del prompt, la relación de aspecto, el nivel de tamaño y el seed.

¿Qué límites tiene la API de FLUX.2 Max?

Resoluciones: 1K · 2K; Relaciones de aspecto: auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 +4; Imágenes de referencia: 3; Longitud del prompt (caracteres): 5,000; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar FLUX.2 Max sin escribir código?

Sí. El Playground ejecuta FLUX.2 Max con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Todos los modelos de FLUX

FLUX.2 Pro es más barato y rápido para el día a día. Max es el de los retratos principales y las portadas.

Otras API de imagen

Más sobre FLUX.2 Max

Pruébalo: FLUX.2 Max: generador de imágenes con IA en línea Crea imágenes con FLUX.2 Max en PopNow
Comparar: FLUX.2 Max vs Nano Banana Pro
Documentación: ID de modelo y esquema de entrada de FLUX.2 Max en la documentación de la API Inicio rápido de la API de PopNow: tu primera solicitud en cinco minutos Guía de generación de imágenes con la API de PopNow Webhooks: recibe los resultados de FLUX.2 Max sin sondeos