Introdução
O FLUX.2 [flex] Edição executa o FLUX.2 [flex] da Black Forest Labs em imagens que você já tem. Ele recebe de uma a três origens e uma instrução, como nova luz, uma nova cena ou texto acrescentado, e devolve um resultado em 1k no formato da origem ou em um de nove formatos.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX.2 [flex] Texto para imagem |
| imagens para alterar ou combinar | FLUX.2 [flex] Edição |
Recursos e destaques
Reiluminação com o sujeito preservado
No nosso teste, um retrato diurno virou uma noite de chuva, com pedras molhadas, luz de vitrine e gotas de chuva, enquanto a mulher, o casaco e a pose permaneceram como estavam.
Composição com várias origens
Cite cada origem pelo número e diga como elas se combinam. Nosso teste de perfume colocou um frasco de uma foto sobre uma bancada de mármore de outra e igualou a luz e o reflexo.
Texto acrescentado sobre o resultado
Coloque entre aspas qualquer título ou rótulo que queira acrescentar. Nossa composição voltou com o título escrito como no prompt; um “No.” em um rótulo pode voltar como o sinal de número.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Diga o que mudar e o que deve permanecer igual, e cite cada origem pela posição, como imagem 1 e imagem 2. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De 1 a 3 imagens de origem, na ordem em que o prompt as cita. O preço é o mesmo, seja qual for o número de origens. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) mantém mais ou menos o tamanho e o formato da primeira origem; ou escolha um de nove formatos, de 21:9 a 9:21. O formato não altera o preço. |
resolution | Não | Só o 1k está disponível na edição. Vale quando você escolhe uma proporção fixa; com auto, o resultado acompanha o tamanho da primeira origem. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o com o mesmo prompt e as mesmas origens para comparar variações lado a lado. |
Preços
$0.115 / imagem
Cobrado por imagem, com um único preço fixo: o número de imagens de origem e a proporção não o alteram. Pedidos recusados e com falha não são cobrados.
Casos de uso
Cenas de produto
Leve uma foto de produto para um cenário produzido e acrescente um rótulo ou um título.
Variações de clima e de atmosfera
Mostre um retrato ao entardecer, na chuva ou sob neon, para um cliente que está escolhendo uma direção.
Paisagens e imagens do dia a dia
Mude o horário, a estação ou o fundo de uma paisagem ou de uma cena de rua.
Guia de prompt e dicas práticas
Diga o que permanece
Depois da mudança, liste o rosto, a roupa e a pose que devem continuar iguais.
Numere as origens
Escreva imagem 1 e imagem 2 no prompt para que cada origem tenha um papel claro.
Fique em material seguro para o trabalho
A edição recusa retratos com muito mais facilidade do que texto para imagem, mesmo no nível Leve; então use-a para produtos, paisagens e retratos do dia a dia.
Escolha auto para manter o enquadramento
Com auto, o resultado acompanha o tamanho da primeira origem. Escolha um formato fixo só quando quiser reenquadrar.
Reserve de um a dois minutos
As edições levaram de 45 a 120 segundos nos nossos testes.
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-flex/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.

























