Introdução
O FLUX.2 [max] Texto para imagem é o modelo de mais alta qualidade da família FLUX.2 da Black Forest Labs, lançado em 16 de dezembro de 2025, e gera imagens a partir de um prompt escrito. Ele é feito para pessoas e luz fotorrealistas, texto legível dentro da imagem e cores definidas por valores hex, em 1k ou 2k e nove proporções.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX.2 Max Texto para imagem |
| de uma a três fotos para alterar ou combinar | FLUX.2 Max Edição |
Recursos e destaques
Pessoas e luz fotorrealistas
Brilho do tecido, textura da pele, profundidade de campo rasa e uma lente e uma direção de luz definidas aparecem com clareza. Nos nossos testes, um vestido de seda de costas abertas na hora azul e um corredor de hotel dos anos 1970 pareceram fotografias.
Texto e cores em hex
Coloque cada linha de texto entre aspas e diga onde ela fica. Nosso exemplo de capa de revista gerou um título, chamadas e uma linha de edição exatamente como escritos, sobre um fundo definido por um valor hex.
Dois níveis de tamanho, nove formatos
O 1k tem cerca de um megapixel e o 2k chega a 2048 pixels no lado maior, do quadrado ao 21:9 e ao 9:21. O formato não altera o preço.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva assunto, figurino, cenário, lente e luz 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 chega a 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 as mudanças com mais facilidade; ele não garante uma imagem idêntica. |
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 com falha ou recusados não são cobrados.
| Especificação | Preço |
|---|---|
| $0.07 / imagem |
| $0.0881 / imagem |
Casos de uso
Retratos editoriais e de campanha
Retratos de moda, de estilo de vida e de marca para moodboards, apresentações e rascunhos de campanha.
Capas, pôsteres e rótulos
Capas de revista, cartazes de eventos e embalagens em que vários textos dividem o quadro com uma imagem.
Fotogramas de cinema
Quadros widescreen com lente, luz e tratamento de cor descritos, para storyboards e arte-chave.
Guia de prompt e dicas práticas
Escreva como um briefing de foto
Assunto, figurino, cenário, lente, direção da luz e tratamento de cor, em frases completas.
Use aspas e posição em todo texto
Toda palavra que deve aparecer vai entre aspas, com uma posição; palavras sem aspas são tratadas como descrição.
Dê as cores em valores hex
O #0F5C4A para um vestido ou o #4A0E1A para um fundo é seguido com mais fidelidade do que o nome de uma cor.
Fique com cenas de nível Leve
O filtro de conteúdo deixa passar cenas de nível Leve, geralmente suaviza tudo o que é mais forte e recusa os pedidos de Muito forte. Pedidos recusados não são cobrados.
Conte com 20 a 90 segundos
A maioria dos nossos pedidos terminou nessa faixa; o 2k e uma fila cheia levam 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-max/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.

























