Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
prompt | Sí | Describe the subject, setting, light and style in plain sentences. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · Por defecto: 1k |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Por defecto: 1:1 |
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 |
|---|---|---|
| resolution 1K | 4,5 | 0,045 US$ |
| resolution 2K | 5,87 | 0,059 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 5 créditos por imagen (0,05 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 Pro 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-pro/text-to-image 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-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"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 Pro
¿Cuánto cuesta la API de FLUX.2 Pro?
FLUX.2 Pro cuesta desde 5 créditos (0,05 US$) por imagen con Crear imagen, su tarea más barata. Precios por opción: 1K 4,5 créditos por imagen, 2K 5,87 créditos por imagen. 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 Pro en la API?
Pon black-forest-labs/flux-2-pro/text-to-image para Crear imagen; black-forest-labs/flux-2-pro/edit para Editar imagen en el campo model de POST /jobs/createTask.
¿Qué es FLUX.2 [pro]?
Es el modelo de nivel de producción de la segunda generación FLUX de Black Forest Labs, lanzado el 25 de noviembre de 2025 y concebido para equilibrar calidad y velocidad. Black Forest Labs lo hizo cerca del doble de rápido en marzo de 2026.
¿Puede escribir texto dentro de las imágenes?
Sí. En nuestra prueba del póster pusimos entre comillas un titular y una línea pequeña, y ambos volvieron escritos tal como se pidieron, con el estilo tipográfico que describía el prompt. Escribe las palabras entre comillas e indica dónde van.
¿Sigue los códigos de color?
Sí. Los códigos hex escritos en el prompt guían la paleta. En nuestra prueba del póster, un verde azulado de atardecer y una franja de horizonte color cobre salieron en los tonos que indicamos.
¿Cuántas imágenes de referencia puedo usar?
De una a tres en una edición. Indica qué aporta cada una: la imagen 1 es la persona, la imagen 2 el producto y la imagen 3 el lugar.
¿El seed repite una imagen?
Un seed fijo sirve para comparar prompts lado a lado; no garantiza un resultado idéntico.
¿Qué límites tiene la API de FLUX.2 Pro?
Resoluciones: 1K · 2K; Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar FLUX.2 Pro sin escribir código?
Sí. El Playground ejecuta FLUX.2 Pro 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 Max es el nivel de máxima calidad para retratos principales; FLUX.2 Flex es el de los rotulados pesados. Pro equilibra calidad y velocidad.
- API de FLUX.2 MaxFLUX de gama alta: luz fotorrealista y colores de marca exactosDesde 11 créditos por imagen
- API de FLUX 3Video con sonido sincronizado y un nivel de boceto rápidoDesde 45 créditos por un clip de 5 segundos
- API de FLUX.2 Klein 9B LoRAFLUX.2 Klein 9B rápido que carga hasta tres de tus LoRADesde 3 créditos por imagen
- API de FLUX.2 Klein Base 9B LoRAKlein 9B sin destilar para looks variados con tus LoRADesde 4 créditos por imagen
- API de FLUX.2 Klein 4B LoRAFLUX.2 Klein 4B pequeño y rápido con tus propios LoRADesde 3 créditos por imagen
- API de FLUX.2 Klein Base 4B LoRAKlein 4B sin destilar que carga tus propios LoRADesde 3 créditos por imagen
- API de FLUX.2 Klein 9BEdiciones rápidas con FLUX que respetan caras y posesDesde 2 créditos por imagen
- API de FLUX.2 Klein 4BEl FLUX más pequeño y veloz, para bocetos rápidosDesde 2 créditos por imagen
- API de FLUX.2 Dev LoRAImágenes y ediciones con FLUX.2 Dev y tus propios LoRADesde 4 créditos por imagen
- API de FLUX.2 ProImágenes fotorrealistas con texto legible y control de color hexDesde 5 créditos por imagen
- API de FLUX.2 FlexEscribe títulos y etiquetas tal cual los ponesDesde 9 créditos por imagen
- API de FLUX.2 DevFLUX de pesos abiertos que puede reunir a varias personas en una escenaDesde 2 créditos por imagen
- API de FLUX.1 Krea Dev LoRAFLUX.1 Krea fotográfico con tus propios LoRADesde 4 créditos por imagen
- API de FLUX.1 Dev ControlNet LoRAControl de pose, profundidad o bordes en FLUX.1, con tus LoRADesde 6 créditos por imagen
- API de FLUX.1 Fill Dev LoRAInpainting con máscara en FLUX.1 Fill y tus propios LoRADesde 7 créditos por imagen
- API de FLUX.1 Dev LoRAEl clásico FLUX.1 Dev con hasta tres de tus LoRADesde 3 créditos por imagen
- API de FLUX.1 Schnell LoRAFLUX.1 Schnell rápido que carga tus propios LoRADesde 1 crédito por imagen

