Introdução
FLUX.2 [klein] 4B Edição de imagem muda ou combina até três imagens de origem com uma instrução escrita, no menor modelo FLUX.2 da Black Forest Labs, que é de código aberto sob Apache 2.0. Mantenha o formato da primeira imagem com auto, ou escolha uma proporção e um nível de tamanho 1k ou 2k. Cada edição tem um preço fixo por imagem e nenhum filtro de conteúdo é aplicado.
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
Até três referências
Combine dois retratos e um local, ou mude o estilo de uma única foto. O preço não muda com o número de origens.
Edições que preservam as pessoas
Peça um novo fundo, luz ou clima e mantenha rostos, roupas e pose. Com uma origem isso funciona limpo; com três, os rostos podem se desviar um pouco.
Aberto, sem filtro
Nada é revisado nem recusado. Em nossos testes, as edições mantiveram a fonte sem filtro como estava; só o nível Muito forte voltou suavizado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que deve mudar e o que deve continuar igual, até 5.000 caracteres. Com várias origens, chame-as de imagem 1, imagem 2 e imagem 3. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a três imagens de origem, de até 10 MB cada, na ordem em que o prompt se refere a elas. Obrigatório. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | Auto (padrão) mantém o formato da primeira origem com cerca de um megapixel. Ou escolha uma de nove proporções, de 21:9 a 9:21. |
resolution | Não | 1k (padrão) ou 2k, que tem 2048 pixels no lado maior. Só vale quando você escolhe uma proporção; com auto, o tamanho é de cerca de um megapixel. |
seed | Não | Um número de 0 a 2147483647. Reutilize-o para comparar edições enquanto muda um detalhe do prompt. |
Preços
$0.013 / imagem
Cobrado por imagem a um preço único, seja qual for o número de imagens de origem ou o nível de tamanho. Requisições com falha não são cobradas.
Casos de uso
Trocas de fundo e de clima
Leve um casal de uma rua ensolarada para uma noite chuvosa de neon numa só passada.
Levar pessoas a um lugar
Coloque dois retratos na foto de um local, para storyboards, capas e fichas de personagem.
Mudanças rápidas de estilo
Mude a luz, a estação ou a paleta mantendo a composição no lugar.
Guia de prompt e dicas práticas
Proteja primeiro, mude depois
Abra com o que deve continuar igual e só então descreva a mudança. Instruções curtas e concretas funcionam melhor.
Dê um papel a cada origem
Com várias imagens, diga o que cada uma contribui: esta pessoa, aquela pessoa, este lugar.
Confira os detalhes
Com duas ou três origens, olhe as mãos, o cabelo e os acessórios; um pequeno item extra pode aparecer. Rode outra seed se algo estiver errado.
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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.

























