Introdução
FLUX.2 [klein] 4B Texto para imagem cria uma imagem a partir de um prompt escrito no menor modelo FLUX.2 da Black Forest Labs, que é de código aberto sob Apache 2.0. Escolha uma de nove proporções com cerca de um megapixel (1k) ou até 2048 pixels no lado maior (2k) e receba um JPEG em aproximadamente 15 a 35 segundos. Nenhum filtro de conteúdo é aplicado ao prompt nem ao resultado.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX.2 Klein 4B Texto para imagem |
| de uma a três imagens para mudar ou combinar | FLUX.2 Klein 4B Edição de imagem |
Recursos e destaques
Pequeno e rápido
Com 4 bilhões de parâmetros, é o modelo FLUX.2 mais leve. Serve para rascunhos, maquetes e para testar muitas ideias em sequência.
Texto entre aspas e cores hexadecimais
Títulos curtos entre aspas e códigos de cor hexadecimais são compreendidos. Os resultados são decentes, não garantidos: as letras podem sair com erro de grafia e uma cor pode aparecer num objeto diferente do pretendido.
Aberto, sem filtro
Nada é revisado nem recusado. O limite é do próprio modelo: ele tende a acrescentar roupas por conta própria, e o nível Muito forte não é renderizado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva sujeito, roupa, cenário e luz em frases completas, até 5.000 caracteres. Coloque entre aspas o texto de placas ou pôsteres e escreva as cores como códigos hexadecimais. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Nove opções de 21:9 a 9:21; o padrão é 1:1. A proporção não muda o preço. |
resolution | Não | Nível de tamanho: o 1k tem cerca de um megapixel (padrão) e o 2k tem 2048 pixels no lado maior. Confira o preço exibido antes de executar. |
seed | Não | Um número de 0 a 2147483647. Reutilize-o enquanto muda um detalhe para comparar os resultados; teste várias seeds quando o texto sair estranho. |
Preços
Cobrado por imagem. O nível de tamanho escolhido aparece no preço exibido antes de você executar; a proporção não o altera. Requisições com falha não são cobradas.
| Especificação | Preço |
|---|---|
| $0.0093 / imagem |
| $0.0099 / imagem |
Casos de uso
Rascunhos antes de se comprometer
Teste uma dúzia de prompts e seeds rapidamente e leve a melhor ideia a um modelo maior se precisar de mais detalhe.
Pôsteres e cenas de neon
Pôsteres de eventos, maquetes de anúncios e cenas noturnas com placas e luz colorida funcionam bem dentro do alcance deste modelo.
Retratos com clima
Sujeitos isolados com uma fonte de luz clara saem limpos, principalmente com as mãos cobertas ou fora do quadro.
Guia de prompt e dicas práticas
Descreva você mesmo a roupa
Este modelo acrescenta roupas por conta própria. Escreva exatamente o que cada pessoa veste, peça por peça, e ele seguirá isso.
Texto entre aspas, e curto
Uma ou duas palavras curtas entre aspas são o mais seguro. Se as letras parecerem erradas, troque só a seed e rode de novo.
Com duas pessoas no quadro, mantenha as mãos simples
As mãos são a primeira coisa a falhar com duas pessoas no quadro. Coloque-as nos ombros, num parapeito ou em luvas, ou rode várias seeds e escolha a melhor.
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-4b/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.
