Clave API de Flux: precios, plan gratuito y documentación de Black Forest Labs

Buscas una clave API de Flux porque quieres generar imágenes desde código y quieres saber el precio antes de asociar una tarjeta. Es lógico. Black Forest Labs vende Flux a través de una API basada en créditos, y las respuestas sobre precios, uso gratuito y límites están repartidas por varias páginas de documentación. Este artículo las reúne en un solo lugar, basándose en la documentación oficial tal como se leyó en octubre de 2026.

En resumen: 1 crédito equivale a $0.01, pagas por imagen (o por segundo de video), la documentación no anuncia ningún crédito gratuito para cuentas nuevas, y el límite predeterminado es de 24 tareas activas a la vez. El resto de esta página muestra cómo se aplican estos datos, con una tabla de todos los precios actuales y una solicitud que puedes ejecutar hoy.

💡 Los precios cambian. Todas las cifras de este artículo proceden de la página de precios y del centro de ayuda de Black Forest Labs. Consulta la página actualizada antes de presupuestar un trabajo grande, porque aparecen nuevos modelos y niveles de resolución con frecuencia.

Configurar tu cuenta de Black Forest Labs

Todo empieza en dashboard.bfl.ai. La cuenta, las credenciales y la facturación están ahí, y la configuración lleva unos cinco minutos.

Crear la cuenta

Abre el panel, haz clic en Login y regístrate con un correo electrónico y una contraseña o con Google. El registro crea automáticamente una Default Organization y un Default Project, así que no hay nada más que configurar. La organización guarda la facturación y el saldo de créditos. El proyecto guarda tus credenciales de API. Si más adelante repartes el trabajo entre clientes o productos, puedes añadir proyectos sin abrir una segunda cuenta.

Generar y guardar el secreto

Dentro de tu proyecto, ve a API, luego a Keys y haz clic en Add Key. Ponle un nombre descriptivo, como production-images. La clave API completa se muestra una sola vez, así que cópiala directamente en un gestor de contraseñas o en una variable de entorno. Tres hábitos te ahorrarán problemas:

• Mantén el secreto fuera de Git y fuera del código del navegador. Cualquiera que lo tenga puede gastar tus créditos.
• Crea una credencial por entorno, para que revocar un secreto de pruebas nunca rompa producción.
• Envíalo en la cabecera x-key de cada solicitud, tal como hace el ejemplo que aparece más adelante en este artículo.

Añadir créditos antes de llamar a la API

Las solicitudes fallan sin saldo, así que primero recarga la cuenta. En la barra lateral ve a API, luego a Credits, haz clic en Add Credits y elige una cantidad. Stripe gestiona el pago y los créditos están disponibles de inmediato. La documentación no indica un mínimo para una compra manual.

La recarga automática es opcional. El umbral que la activa debe ser de al menos $5, y el objetivo de recarga debe estar al menos $10 por encima de ese umbral. Si un cargo automático falla, la recarga automática se desactiva sola hasta que la vuelvas a activar, así que revisa los datos de tu tarjeta antes de una ejecución larga sin supervisión.

Cuánto cuesta Flux por imagen

Black Forest Labs maneja tres sistemas de precios a la vez. Los modelos más antiguos, FLUX.1, cobran una cantidad fija de créditos por imagen. La familia FLUX.2 cobra por megapíxel. Los modelos más nuevos, FLUX 3, cobran por nivel de resolución o, en el caso del video, por segundo. El playground cobra lo mismo que la API, así que probar en el navegador no es una forma gratuita de evitar el cobro.

Precios fijos en créditos de FLUX.1

Son los más fáciles de presupuestar, porque una solicitud cuesta lo mismo en cualquier tamaño compatible.

Kontext es la línea de edición: envías una imagen y una instrucción, y el modelo cambia lo que describes. Fill Pro se encarga del inpainting y el outpainting.

Precios de FLUX.2 por megapíxel

Los precios de FLUX.2 empiezan bajos y suben con la resolución: el primer megapíxel cuesta una tarifa fija, y cada megapíxel adicional suma al total. Las cifras siguientes son los precios de partida.

Klein 4B y 9B son la pareja económica, Pro es la opción habitual para producción y Max ocupa el extremo más caro de la lista de precios. Flux 2 Dev no tiene precio en la API porque la documentación lo indica como solo local.

Tarifas de imagen y video de FLUX 3

FLUX 3 separa el precio de las imágenes según el tamaño de salida.

El video se cobra por segundo. Texto a video e imagen a video van de $0.17 a $0.80 por segundo para un render completo, mientras que un render de borrador cuesta $0.06 por segundo. Un borrador de cinco segundos cuesta, por tanto, $0.30, y un render completo de cinco segundos cuesta al menos $0.85. Puedes probar Flux 3 como modelo de texto a video en PicassoIA antes de comprometerte con sus tarifas de API.

¿Existe un plan gratuito real?

Respuesta corta: no hay ninguno que la documentación anuncie.

Lo que dice realmente la documentación

La página de precios empieza con una sola regla: 1 crédito equivale a $0.01 USD, se paga por imagen y el precio es el mismo para la API y el playground. No indica créditos de bienvenida, cuota mensual gratuita ni prueba. Las páginas de créditos y facturación tampoco mencionan créditos de prueba. Los rastreadores independientes de precios llegan a la misma conclusión: no existe un plan gratuito tradicional. Si hay alguna promoción activa, revisa tu panel después de registrarte, porque no hay ninguna documentada.

Así que planifica un primer depósito pequeño. Una recarga de $10 compra 1,000 créditos. Eso son 250 imágenes con Flux 1.1 Pro a 4 créditos cada una, o más de 700 imágenes con Flux 2 Klein 4B a $0.014 cada una.

💡 Prueba primero lo barato. Ejecuta tus plantillas de prompt en el modelo más económico antes de gastar créditos en Max o Ultra. Un prompt malo cuesta lo mismo en cualquier modelo.

Opciones gratuitas que sí existen

Hay tres caminos para evitar pagar a Black Forest Labs por imagen:

• Alojar pesos abiertos por tu cuenta. Flux 2 Klein 4B y Flux Schnell son modelos de pesos abiertos, así que puedes ejecutarlos en tu propio hardware sin tarifa por imagen dentro de los términos de su licencia. En cambio, pagas tu propia GPU, y la licencia cambia según el modelo, así que revisa la ficha de cada uno. Flux 2 Dev figura como solo local, y sus pesos tienen una licencia no comercial, así que léela antes de usarlo en un producto de pago.
• Usar una herramienta de navegador alojada. PicassoIA ejecuta los modelos Flux en el navegador sin configurar ninguna API. Su página de Flux 2 Pro describe el modelo como gratuito, en línea y sin necesidad de programar.
• Hacer prototipos con el modelo de pago más barato. A $0.014 por imagen, unos cientos de experimentos cuestan menos que un café.

Límites de uso y URL de los resultados

Dos reglas condicionan cualquier integración: cuántos trabajos pueden ejecutarse a la vez y cuánto tiempo tienes para descargar el resultado.

24 tareas activas por defecto

El límite de concurrencia es el número de solicitudes que una cuenta puede tener en curso al mismo tiempo. Por defecto son 24 tareas activas. Dos modelos tienen límites más estrictos: flux-kontext-max está limitado a 6 tareas activas, y el video de FLUX 3 empieza con 5 tareas de video simultáneas. Son posibles límites más altos si contactas con el soporte de Black Forest Labs.

Cuando superas el límite, la API responde con HTTP 429. No se pierde nada: espera a que termine una de tus tareas anteriores y vuelve a enviar la solicitud. En código, eso significa un semáforo (semaphore) limitado un poco por debajo de 24 y un reintento con backoff al recibir un 429. El límite cuenta las tareas que siguen en ejecución, no las solicitudes por segundo, así que un modelo más rápido permite sacar más imágenes por el mismo techo.

Diez minutos para descargar

La respuesta a tu primer POST contiene un id y una polling_url. Usa esa URL, no una que construyas tú, sobre todo en el endpoint global api.bfl.ai o en los regionales, api.eu.bfl.ai y api.us.bfl.ai. Consulta el estado hasta que aparezca Ready, Error o Failed.

La URL firmada de un resultado listo es válida solo durante 10 minutos. Descarga el archivo y cópialo en tu propio almacenamiento, como S3 o R2, en cuanto el estado cambie a Ready. Si tu worker está caído cuando termina el trabajo, la salida caduca y tendrás que volver a generar la imagen.

Tu primera solicitud

Este es un script mínimo en Python que usa el endpoint de Flux 1.1 Pro, que cuesta 4 créditos ($0.04) por imagen. Define primero BFL_API_KEY en tu entorno.

import os, time, requests

BASE = "https://api.bfl.ai/v1"
HEADERS = {"x-key": os.environ["BFL_API_KEY"], "accept": "application/json"}

job = requests.post(
    f"{BASE}/flux-pro-1.1",
    headers=HEADERS,
    json={
        "prompt": "A ceramic perfume bottle on a white table, soft window light",
        "width": 1024,
        "height": 768,
    },
).json()

while True:
    result = requests.get(job["polling_url"], headers=HEADERS).json()
    if result["status"] == "Ready":
        break
    if result["status"] in ("Error", "Failed"):
        raise RuntimeError(result)
    time.sleep(1)

image = requests.get(result["result"]["sample"]).content
open("bottle.jpg", "wb").write(image)

Copiar prompt

El script envía un trabajo, lee el polling_url de la respuesta, lo comprueba una vez por segundo y guarda la imagen antes de que caduque la URL firmada. Para usar otro modelo, cambia la ruta del endpoint por la que aparece para él en la referencia de la API en docs.bfl.ai. La referencia de la API también documenta una llamada que devuelve tus créditos restantes, y conviene ejecutarla antes de cualquier lote grande.

Controlar los costos a escala

Las pequeñas diferencias por imagen se convierten en dinero real con el volumen. La tabla muestra lo que cuestan 1,000 imágenes con cada precio de partida.

Elige el modelo más barato que funcione

Un patrón sensato es hacer borradores con un modelo Klein y luego regenerar solo los ganadores en Pro o Max. Para las ediciones, empieza con Kontext Pro y pasa a Kontext Max solo cuando el resultado lo necesite. Kontext Max también tiene el límite de concurrencia más estricto, así que no encaja bien con trabajos masivos.

Presupuesta antes de hacer lotes

Las solicitudes por lotes multiplican el costo base por el número de imágenes, así que 200 imágenes con Flux 1.1 Pro cuestan 200 veces $0.04, es decir, $8. Los créditos están a nivel de organización y se comparten entre sus proyectos, así que los proyectos separados no te dan presupuestos separados. Activa la recarga automática solo después de fijar un umbral que te puedas permitir perder por culpa de un bucle descontrolado, y revisa la llamada de saldo de créditos al inicio de cada trabajo grande.

Flux 2 Pro en PicassoIA

Si quieres imágenes en lugar de una integración, puedes saltarte la configuración de la cuenta, los créditos y el código. PicassoIA aloja Flux 2 Pro en el navegador, y acepta hasta ocho imágenes de referencia junto a tu prompt.

Cómo usar Flux 2 Pro

Así se usa Flux 2 Pro en PicassoIA, paso a paso:

1. Abre la página de Flux 2 Pro en PicassoIA.
2. Escribe tu prompt. Es el único campo obligatorio. Describe el sujeto, la luz y el objetivo, como en "a ceramic perfume bottle on a white table, soft window light, 85mm lens".
3. Opcionalmente, añade hasta 8 imágenes de referencia (JPEG, PNG, GIF o WebP) para orientar el estilo, el sujeto o la composición. Menciónalas en el prompt como imagen 1, imagen 2 y así sucesivamente.
4. Elige una relación de aspecto y una resolución. El valor predeterminado es 1 MP, y la página del modelo recomienda 2 MP o menos.
5. Elige el formato de salida y la calidad, y luego inicia la generación.
6. Guarda el resultado que te guste y reutiliza su semilla si quieres reproducirlo más adelante.

Consejos de parámetros que importan

El ancho y el alto personalizados deben ser múltiplos de 32, y la salida máxima es de 2048 x 2048 píxeles, así que las proporciones muy anchas no alcanzarán los 4 MP completos.

Otros modelos de Flux para probar

• Flux 2 Max y Flux 2 Flex para el extremo superior de la familia FLUX.2.
• Flux 2 Klein 4B y Flux 2 Klein 9B para borradores rápidos y de bajo costo.
• Flux 1.1 Pro Ultra para salidas de alta resolución.
• Flux Kontext Pro para editar una foto existente con una instrucción escrita.
• Flux 3 para texto a video.

Prueba Flux en Picasso IA hoy

La API de Black Forest Labs es la herramienta adecuada cuando estás creando un producto que llama a Flux miles de veces. Para todo lo demás, la forma más rápida de ver lo que hacen estos modelos es escribir un prompt y mirar el resultado.

Abre Picasso IA, elige Flux 2 Pro o cualquier modelo de la lista completa de modelos, y genera tu primera imagen en unos minutos. Prueba el mismo prompt en dos o tres modelos, compara los resultados lado a lado y anota cuál merece su precio. Cuando sepas qué modelo encaja con tu trabajo, también sabrás qué endpoint de la API debes presupuestar.