Introdução
O FLUX.2 [max] Edição aplica o modelo de mais alta qualidade do FLUX.2 da Black Forest Labs a fotos que você já tem. Ele recebe de uma a três origens e uma instrução, e devolve uma imagem no formato da primeira origem ou em uma de nove proporções, em 1k ou 2k.
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
Até três referências
Combine pessoas e lugares de fotos separadas em um único pedido. No nosso teste da livraria, dois retratos e um ambiente viraram uma cena só, com cada rosto, penteado e roupa preservados e a luz dos abajures do local sobre as duas mulheres.
Mudanças de fundo e de luz
Troque o fundo de estúdio por um porto na hora dourada e reilumine o sujeito, com rosto, barba, expressão e roupa intactos.
Um preço por edição
A edição é cobrada por imagem, com um único preço, seja qual for o número de origens ou o nível de tamanho. Pedidos recusados não são cobrados.
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 continuar igual. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De 1 a 3 imagens de origem, de até 10 MB cada. Diga no prompt o que cada uma traz: uma pessoa, um ambiente, um produto. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) mantém o formato da primeira imagem de origem, com cerca de um megapixel; ou escolha um de nove formatos, de 21:9 a 9:21. O formato não altera o preço. |
resolution | Não | 1k (padrão) ou 2k, usado apenas quando você escolhe uma proporção; com auto, o resultado fica em cerca de um megapixel. A edição custa o mesmo nos dois níveis. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o com o mesmo prompt e as mesmas origens para comparar as mudanças com mais facilidade; ele não garante uma imagem idêntica. |
Preços
$0.076 / imagem
Cobrado por imagem, com um preço por edição, seja qual for o número de imagens de origem ou o nível de tamanho. Pedidos com falha ou recusados não são cobrados.
Casos de uso
Fotografia de produtos e lugares
Novos fundos, nova luz e cenas consistentes para imagens de catálogo e de campanha.
Retoque de retratos do dia a dia
Mude o cenário, a luz ou o estilo de um retrato do dia a dia mantendo a pessoa reconhecível.
Cenas de grupo a partir de fotos separadas
Leve pessoas de retratos individuais para um mesmo ambiente ou local.
Guia de prompt e dicas práticas
Diga o que permanece igual
Depois da mudança, liste os rostos, cabelos, roupas e poses que não podem se mexer.
Numere as origens
Chame-as de imagem 1, imagem 2 e imagem 3, na ordem em que você as enviou, e dê um papel a cada uma.
Use fotos de origem limpas e do dia a dia
As edições são filtradas com rigor: em nossos testes, o Max recusou edições de retratos mesmo no nível Leve. Produtos, lugares e retratos com roupas comuns são o material seguro.
Escolha auto para manter o enquadramento
O auto mantém o formato da primeira origem; escolha uma proporção e um nível quando quiser outro recorte ou o 2k.
Reserve até dois minutos
Nossas edições levaram cerca de 45 a 120 segundos.
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/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.

























