Introducción
FLUX.2 [flex] Texto a imagen es el modelo FLUX.2 de Black Forest Labs para texto y composición, lanzado el 25 de noviembre de 2025. Convierte un prompt escrito en una imagen, escribe en ella el texto entre comillas tal como se pide, sigue los códigos de color hex y genera en 1k o 2k y nueve formas.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 [flex] Texto a imagen |
| imágenes para cambiar o combinar | FLUX.2 [flex] Edición |
Funciones y aspectos destacados
Texto que vuelve tal como se escribió
En nuestras pruebas, un póster de película con título, eslogan y línea de estreno, una portada de disco con un título en letra cursiva y una etiqueta de lata de té volvieron con cada línea entre comillas bien escrita.
Color con códigos hex
Escribe un código junto a un objeto grande, un fondo o el etalonaje y el resultado se mantiene cerca de él. En textos muy pequeños el tono puede desviarse.
Dos niveles de tamaño, nueve formas
1k equivale a cerca de un megapíxel y 2k genera 2048 píxeles en el lado largo, desde banners 21:9 hasta stories 9:21. El nivel 2k cuesta más que 1k; la forma nunca cambia el precio.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Describe el sujeto, el escenario, la luz y el estilo 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 genera 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 variaciones lado a lado. |
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 rechazadas o fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.0578 / imagen |
| $0.0881 / imagen |
Casos de uso
Pósteres y portadas
Pósteres de cine, portadas de discos y títulos de revista donde el texto es parte del diseño.
Empaques y fotos de producto
Etiquetas, latas y botellas en colores de marca específicos, fotografiadas en un entorno estilizado.
Titulares publicitarios
Un titular y una línea de texto sobre una escena iluminada, listos para una presentación o un primer diseño.
Guía de prompts y consejos prácticos
Pon entre comillas y ubica cada línea
Escribe cada línea de texto entre comillas e indica dónde va. Termina con “No other text” para evitar que aparezcan palabras de más.
Da los colores como códigos
Nombra el objeto y el valor hex juntos, por ejemplo una etiqueta color crema #F3E9D2 con un borde dorado #C9A227.
Describe a las personas por su ropa y su pose
Indica qué viste cada persona, dónde está y hacia dónde mira. Los retratos de nivel Suave se generan; las solicitudes más fuertes se rechazan o se suavizan.
Empieza en 2k para el texto
Los tamaños mayores dan más píxeles al texto pequeño, lo que mejora la legibilidad. Usa 1k para borradores rápidos.
Cuenta con 20 a 90 segundos
La mayoría de las solicitudes terminaron en ese rango en nuestras pruebas; una cola llena tarda 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-flex/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.

























