Introducción
FLUX.2 [max] Texto a imagen es el modelo de mayor calidad de la familia FLUX.2 de Black Forest Labs, lanzado el 16 de diciembre de 2025, y genera imágenes a partir de un prompt escrito. Está pensado para personas y luz fotorrealistas, texto legible dentro de la imagen y colores definidos con valores hex, en 1k o 2k y nueve relaciones de aspecto.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 Max Texto a imagen |
| de una a tres fotos para cambiar o combinar | FLUX.2 Max Edición |
Funciones y aspectos destacados
Personas y luz fotorrealistas
El brillo de las telas, la textura de la piel, la poca profundidad de campo y un lente y una dirección de luz bien definidos se aprecian con claridad. En nuestras pruebas, un vestido de seda de espalda descubierta en la hora azul y un pasillo de hotel de los años setenta parecían fotografías.
Texto y colores hex
Pon entre comillas cada línea de texto e indica dónde va. Nuestro ejemplo de portada de revista generó un título, líneas de portada y una línea de número exactamente como se escribieron, sobre un fondo definido con un valor hex.
Dos niveles de tamaño, nueve formas
1k equivale a cerca de un megapíxel y 2k llega a 2048 píxeles en el lado largo, del cuadrado a 21:9 y 9:21. La forma no cambia el precio.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Describe el sujeto, la ropa, el escenario, el lente y la luz en frases sencillas. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Una de nueve formas, de 21:9 a 9:21; 1:1 por defecto. La forma no cambia el precio. |
resolution | No | 1k (por defecto) equivale a cerca de un megapíxel; 2k llega a 2048 píxeles en el lado largo. 2k cuesta más que 1k. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo con el mismo prompt para comparar los cambios con más facilidad; no garantiza una imagen idéntica. |
Precios
Se factura por imagen según el nivel de tamaño; 2k cuesta más que 1k y la relación de aspecto no cambia el precio. Las solicitudes fallidas o rechazadas no se cobran.
| Especificación | Precio |
|---|---|
| $0.07 / imagen |
| $0.0881 / imagen |
Casos de uso
Retratos editoriales y de campaña
Retratos de moda, estilo de vida y marca para moodboards, presentaciones y borradores de campaña.
Portadas, pósteres y etiquetas
Portadas de revista, pósteres de eventos y empaques donde varios textos comparten el encuadre con una imagen.
Fotogramas cinematográficos
Encuadres panorámicos con lente, luz y etalonaje descritos, para storyboards y arte clave.
Guía de prompts y consejos prácticos
Escríbelo como un brief fotográfico
Sujeto, ropa, escenario, lente, dirección de la luz y etalonaje, en frases completas.
Pon entre comillas y ubica todo el texto
Cada palabra que deba aparecer va entre comillas con su posición; las palabras sin comillas se toman como descripción.
Da los colores como valores hex
#0F5C4A para un vestido o #4A0E1A para un fondo se sigue con más precisión que el nombre de un color.
Mantente en escenas de nivel Suave
El filtro de contenido deja pasar las escenas de nivel Suave, suele suavizar cualquier cosa más fuerte y rechaza las solicitudes de Muy fuerte. Las solicitudes rechazadas no se cobran.
Cuenta con 20 a 90 segundos
La mayoría de nuestras solicitudes terminaron en ese rango; 2k y una cola llena tardan más.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-max/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.

























