Introdução
O FLUX.2 [pro] Texto para imagem é o modelo de produção da geração FLUX.2 da Black Forest Labs, lançado em 25 de novembro de 2025. Ele transforma um prompt escrito em uma imagem fotográfica em 1k ou 2k e nove proporções, com texto que se lê corretamente dentro da imagem e cores que você define com códigos hex.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX.2 [pro] Texto para imagem |
| de uma a três imagens para alterar ou combinar | FLUX.2 [pro] Edição |
Recursos e destaques
Texto legível na imagem
Coloque as palavras entre aspas e diga onde ficam. No nosso teste de pôster, um título em serifa e uma linha pequena sem serifa voltaram escritos exatamente como no prompt.
Controle de cor por código hex
Escreva as cores como códigos hex e a paleta acompanha. Nosso pôster usou um verde-azulado e um tom de cobre, e o mar e a faixa do horizonte os assumiram.
Realismo documental
Textura de pele, luz de janela e granulação de filme parecem fotografias. Nosso retrato na sacada manteve sardas e linhas finas em 2k.
Com moderação e limites
O nível Leve é renderizado. Em nossos testes, o nível Moderado foi renderizado em algumas execuções e voltou suavizado em outras, os pedidos de nível Forte voltaram suavizados, e o nível Muito forte foi recusado sem cobrança.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 5.000 caracteres. Descreva assunto, roupa, cenário, luz e lente em frases simples. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Um de nove formatos: 1:1 (padrão), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. O formato não altera o preço. |
resolution | Não | 1k (padrão) tem cerca de um megapixel; 2k tem 2048 pixels no lado maior. O nível de tamanho afeta o preço. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o enquanto muda o prompt para comparar variações lado a lado; ele não garante uma imagem idêntica. |
Preços
Cobrado por imagem, conforme o nível de tamanho; a proporção não altera o preço. Pedidos recusados e com falha não são cobrados.
| Especificação | Preço |
|---|---|
| $0.03 / imagem |
| $0.0391 / imagem |
Casos de uso
Pôsteres e rascunhos de campanha
Um título, uma frase de efeito e uma fotografia em um só quadro, para conceitos de perfume, moda ou produto.
Retratos de casais e de personagens
Duas pessoas com cabelo, roupa e clima distintos em uma cena espontânea, para histórias, moodboards e fichas de personagem.
Visuais para redes sociais em qualquer formato
Quadros quadrados, verticais, horizontais e ultrawide a partir do mesmo prompt, bastando mudar o formato.
Guia de prompt e dicas práticas
Escreva frases completas
Assunto, roupa, cenário, luz e lente em frases funcionam melhor do que uma lista de palavras-chave.
Use aspas no texto e nomeie o estilo dele
Coloque cada linha entre aspas e descreva a tipografia, por exemplo um título em serifa de espaçamento largo no alto.
Fixe a paleta
Dê códigos hex para as duas ou três cores que importam e diga onde elas aparecem.
Faça o rascunho em 1k
Teste uma composição em 1k e depois renderize a escolhida em 2k. O nível de tamanho afeta o preço.
Use uma seed para comparar
Mantenha a seed fixa enquanto muda uma só expressão, para que as diferenças venham da sua redação.
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-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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
























