Introducción
FLUX.2 [pro] Texto a imagen es el modelo de producción de Black Forest Labs de la generación FLUX.2, lanzado el 25 de noviembre de 2025. Convierte un prompt escrito en una imagen fotográfica en 1k o 2k y nueve relaciones de aspecto, con texto que se lee bien dentro de la imagen y colores que puedes definir con códigos hex.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 [pro] Texto a imagen |
| de una a tres imágenes para cambiar o combinar | FLUX.2 [pro] Edición |
Funciones y aspectos destacados
Texto legible en la imagen
Pon las palabras entre comillas e indica dónde van. En nuestra prueba del póster, un titular serif y una línea pequeña sans-serif volvieron escritos exactamente como se pidieron.
Control del color con códigos hex
Escribe los colores como códigos hex y la paleta los sigue. Nuestro póster usó un verde azulado y un tono cobre, y el mar y la franja del horizonte los tomaron.
Realismo documental
La textura de la piel, la luz de ventana y el grano de película se leen como fotografías. Nuestro retrato del balcón conservó pecas y líneas finas en 2k.
Con moderación y límites
El nivel Suave se renderiza. En nuestras pruebas, el nivel Moderado se renderizó en algunas ejecuciones y volvió suavizado en otras, las solicitudes de nivel Fuerte volvieron suavizadas, y el nivel Muy fuerte se rechazó sin cobro.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5000 caracteres. Describe el sujeto, la ropa, el escenario, la luz y el lente en frases sencillas. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Una de nueve formas: 1:1 (por defecto), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. La forma no cambia el precio. |
resolution | No | 1k (por defecto) equivale a cerca de un megapíxel; 2k son 2048 píxeles en el lado largo. El nivel de tamaño afecta el precio. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo mientras cambias el prompt para comparar variaciones lado a lado; no garantiza una imagen idéntica. |
Precios
Se factura por imagen según el nivel de tamaño; la relación de aspecto no cambia el precio. Las solicitudes rechazadas o fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.03 / imagen |
| $0.0391 / imagen |
Casos de uso
Pósteres y borradores de campaña
Un titular, un eslogan y una fotografía en un mismo encuadre, para conceptos de fragancia, moda o producto.
Retratos de parejas y de personajes
Dos personas con cabello, ropa y ambiente distintos en una escena espontánea, para historias, moodboards y fichas de personajes.
Visuales para redes en cualquier forma
Encuadres cuadrados, verticales, anchos y ultraanchos a partir del mismo prompt con solo cambiar la forma.
Guía de prompts y consejos prácticos
Escribe frases completas
Sujeto, ropa, escenario, luz y lente en frases funciona mejor que una lista de palabras clave.
Pon el texto entre comillas y nombra su estilo
Escribe cada línea entre comillas y describe la tipografía, por ejemplo un titular serif de letras muy espaciadas en la parte superior.
Fija la paleta
Da códigos hex para los dos o tres colores que importan e indica dónde aparecen.
Haz borradores en 1k
Prueba una composición en 1k y renderiza la definitiva en 2k. El nivel de tamaño afecta el precio.
Usa un seed para comparar
Mantén el seed fijo mientras cambias una frase, para que las diferencias vengan de tu redacción.
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-pro/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.
























