Introdução
O FLUX.2 [flex] Texto para imagem é o modelo FLUX.2 da Black Forest Labs para texto e layout, lançado em 25 de novembro de 2025. Ele transforma um prompt escrito em uma imagem, escreve nela o texto entre aspas tal como indicado, segue códigos de cor hex e gera em 1k ou 2k e nove formatos.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX.2 [flex] Texto para imagem |
| imagens para alterar ou combinar | FLUX.2 [flex] Edição |
Recursos e destaques
Texto que volta como foi escrito
Nos nossos testes, um pôster de filme com título, frase de efeito e linha de estreia, uma capa de álbum com título cursivo e o rótulo de uma lata de chá voltaram com todas as linhas entre aspas escritas corretamente.
Cor por código hex
Escreva um código ao lado de um objeto grande, de um fundo ou do tratamento de cor e a imagem fica próxima dele. Em letras muito pequenas, o tom pode variar.
Dois níveis de tamanho, nove formatos
O 1k tem cerca de um megapixel e o 2k gera 2048 pixels no lado maior, de banners 21:9 a stories 9:21. O 2k custa mais que o 1k; o formato nunca altera o preço.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva assunto, cenário, luz e estilo em frases simples. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Um de nove formatos, de 21:9 a 9:21; 1:1 por padrão. O formato não altera o preço. |
resolution | Não | 1k (padrão) tem cerca de um megapixel; 2k gera 2048 pixels no lado maior. O 2k custa mais que o 1k. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o com o mesmo prompt para comparar variações lado a lado. |
Preços
Cobrado por imagem, conforme o nível de tamanho; o 2k custa mais que o 1k e a proporção não altera o preço. Pedidos recusados e com falha não são cobrados.
| Especificação | Preço |
|---|---|
| $0.0578 / imagem |
| $0.0881 / imagem |
Casos de uso
Pôsteres e capas
Pôsteres de filme, capas de álbum e títulos de revista em que o texto faz parte do design.
Embalagens e fotos de produto
Rótulos, latas e garrafas em cores de marca específicas, fotografados em um cenário produzido.
Títulos de anúncio
Um título e uma linha de texto sobre uma cena iluminada, prontos para uma apresentação ou um primeiro layout.
Guia de prompt e dicas práticas
Use aspas e posição em cada linha
Coloque cada linha de texto entre aspas e diga onde ela fica. Termine com “No other text” para evitar palavras extras.
Dê as cores como códigos
Cite o objeto e o valor hex juntos, por exemplo um rótulo creme #F3E9D2 com borda dourada #C9A227.
Descreva as pessoas por roupa e pose
Diga o que cada pessoa veste, onde fica e para onde olha. Retratos de nível Leve são gerados; pedidos mais fortes são recusados ou suavizados.
Comece em 2k quando houver texto
Tamanhos maiores dão mais pixels às letras pequenas, o que ajuda na legibilidade. Use 1k para rascunhos rápidos.
Conte com 20 a 90 segundos
A maioria dos pedidos terminou nessa faixa nos nossos testes; uma fila cheia leva mais tempo.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.

























