Introdução
FLUX.2 [klein] 9B Texto para imagem é o modelo de imagem pequeno e rápido da Black Forest Labs, lançado em 15 de janeiro de 2026, que gera imagens a partir de um prompt escrito. Renderiza em 1k ou 2k, em nove proporções, em geral em 15 a 35 segundos, e não tem filtro de conteúdo.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX.2 Klein 9B Texto para imagem |
| imagens para mudar | FLUX.2 Klein 9B Edição |
Recursos e destaques
Rápido o bastante para iterar
A maioria das nossas imagens ficou pronta em 15 a 35 segundos, então testar cinco redações ou cinco seeds custa pouco tempo. É o lado rápido da linha FLUX.2.
Texto e folhas de looks
Coloque entre aspas um título ou uma placa e, em geral, ele sai como escrito. Um único prompt também pode dispor vários looks da mesma pessoa numa grade. Nenhum dos dois é garantido em todas as seeds.
Sem filtro, com limites honestos
Nada é recusado. O limite é do modelo: ele costuma acrescentar peças por conta própria e não entrega o nível Muito forte.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 5.000 caracteres. Descreva sujeito, roupa, cenário, luz e estilo em frases simples; coloque entre aspas as palavras que devem aparecer na imagem. 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 muda o preço. |
resolution | Não | 1k (padrão, cerca de um megapixel) ou 2k (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 para comparar mudanças no prompt lado a lado; deixe vazio para uma aleatória. |
Preços
Cobrado por imagem conforme o nível de tamanho: o 2k custa mais que o 1k, e a proporção não muda o preço. Requisições com falha ou recusadas não são cobradas.
| Especificação | Preço |
|---|---|
| $0.011 / imagem |
| $0.0122 / imagem |
Casos de uso
Lotes de variações
Várias versões de uma ideia, para escolher ou para levar a uma edição.
Folhas de looks de personagem
Várias roupas de um mesmo personagem num único quadro.
Rascunhos para modelos maiores
Defina a composição aqui antes de gastar com um modelo maior.
Guia de prompt e dicas práticas
Diga o que as pessoas vestem
A peça, o corte e o caimento. Sem isso, o modelo preenche a roupa por conta própria.
Texto entre aspas, e curto
Poucas palavras por linha saem melhor. Se uma palavra sair errada, troque a seed.
Não conte com cores hexadecimais exatas
Um valor hexadecimal leva à direção certa, não ao tom exato.
Comece em 1k
É o nível mais barato; passe ao 2k para a imagem que você vai manter.
Teste três seeds
Modelos pequenos variam. Mãos e textos finos melhoram na segunda ou terceira tentativa.
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-klein-9b/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.
























