Introdução
FLUX.2 Dev Texto para imagem é o FLUX.2 [dev] da Black Forest Labs, um modelo de pesos abertos com 32 bilhões de parâmetros lançado em 25 de novembro de 2025, que gera uma imagem a partir de um prompt escrito. Ele renderiza texto legível dentro da imagem, segue códigos de cor hexadecimais e entrega cerca de um megapixel no 1k ou até 2048 pixels no lado maior no 2k, em nove proporções. Nenhum filtro é aplicado ao prompt nem ao resultado.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX.2 Dev Texto para imagem |
| de uma a três imagens para mudar ou combinar | FLUX.2 Dev Edição de imagem |
Recursos e destaques
Texto que volta escrito certo
Textos curtos entre aspas em placas, neon e rótulos saíram corretos nos nossos testes: uma placa "CLOSED" na porta de uma loja e um letreiro de neon "VACANCY" foram escritos como pedido.
Controle de cor por código hexadecimal
Escreva um código como #FF4F8B ou #3AA7FF ao lado da luz ou do objeto que você descreve. É uma dica forte, então serve mais para clima e iluminação do que para igualar a cor exata de uma marca.
Sem filtro, com os limites do próprio modelo
Nada é revisado nem recusado. Em nossos testes o modelo entregou os níveis Leve, Moderado, Forte e Máximo em todas as execuções, mas o nível Muito forte voltou suavizado, então não é o modelo para esse nível.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva sujeito, roupa, cenário, luz e visual de câmera em frases completas. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Nove formatos de 21:9 a 9:21; o padrão é 1:1. No 1k têm cerca de um megapixel, por exemplo 1344 x 768 em 16:9. |
resolution | Não | O 1k (padrão) tem cerca de um megapixel; o 2k chega a 2048 pixels no lado maior. Os dois níveis custam o mesmo. |
seed | Não | Um número inteiro de 0 a 2147483647. Mantenha-o fixo enquanto muda uma parte do prompt, para comparar os resultados com facilidade. |
Preços
Cobrado por imagem: o 1k e o 2k custam o mesmo, e a proporção não muda o preço. Requisições com falha não são cobradas.
| Especificação | Preço |
|---|---|
| $0.0116 / imagem |
| $0.0116 / imagem |
Casos de uso
Retratos e fotos de estilo de vida
Fotografias em estilo de filme de uma ou duas pessoas num cenário crível, para moodboards, capas e referências de personagem.
Placas, pôsteres e rótulos
Cenas em que algumas palavras precisam ser legíveis, como vitrines, letreiros de neon, embalagens e pôsteres.
Plataformas sem moderação
Para serviços cujos usuários esperam nenhuma moderação no prompt, com todos os níveis de Leve a Máximo, exceto o nível Muito forte.
Guia de prompt e dicas práticas
Escreva como um briefing de fotografia
Sujeito, roupa, lugar, luz e visual de filme, em frases completas. O FLUX.2 segue bem prompts longos.
Entre aspas, a palavra; na cena, a placa
Coloque o texto exato entre aspas e diga onde ele fica. Use poucas palavras; parágrafos longos ainda podem ter erros.
Nomeie a luz e a cor dela
"Abajures de tungstênio quentes em #E9A23B" ou "neon rosa banhando o quarto em #FF4F8B" dá à cena uma direção de cor clara.
Gere em 2k na versão final
Teste as ideias em 1k e depois renderize a escolhida em 2k com a mesma seed para comparar. O preço é o mesmo nos dois níveis.
Diga o que as pessoas vestem
Se quiser um figurino específico, descreva-o. Em nossos testes o modelo seguiu o que o prompt dizia sobre a roupa.
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-dev/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.
























