Introdução
FLUX.2 Dev Edição de imagem muda ou combina até três imagens de origem no FLUX.2 [dev] da Black Forest Labs, um modelo de pesos abertos com 32 bilhões de parâmetros. Descreva a nova roupa, o cenário ou a luz, diga o que deve ficar e receba uma imagem. Ele mantém os rostos próximos das origens, pode colocar pessoas de fotos separadas numa só cena e não aplica filtro às origens, ao prompt nem ao resultado.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| de uma a três imagens para mudar ou combinar | FLUX.2 Dev Edição de imagem |
| só uma descrição escrita | FLUX.2 Dev Texto para imagem |
Recursos e destaques
Até três referências
Liste as imagens na ordem em que o prompt as menciona e chame-as de imagem 1, imagem 2 e imagem 3. No nosso teste, uma mulher de um retrato e um homem de outro dançaram juntos numa nova cena, com os dois rostos ainda próximos das fotos.
Enquadramento que segue a origem
Com o formato em auto, o resultado mantém as proporções da primeira imagem com cerca de um megapixel. Escolha uma proporção e o 2k quando quiser outro recorte ou mais pixels.
Um preço fixo
O preço por imagem é o mesmo com uma, duas ou três origens e em 1k ou 2k.
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 uma a três imagens de origem, de até 10 MB cada, na ordem em que o prompt se refere a elas ("imagem 1", "imagem 2"). Fotos nítidas e de frente preservam melhor os rostos. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) segue o formato da primeira imagem de origem com cerca de um megapixel. Escolha uma das nove proporções de 21:9 a 9:21 para recortar de novo. |
resolution | Não | 1k (padrão) ou 2k, usado apenas quando você escolhe uma proporção específica. Com auto, o resultado fica em cerca de um megapixel. |
seed | Não | Um número inteiro de 0 a 2147483647. Mantenha-o fixo enquanto ajusta o prompt para comparar os resultados com facilidade; não garante uma imagem idêntica. |
Preços
$0.023 / 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
Nova roupa e novo cenário para a mesma pessoa
Leve uma pessoa de um escritório para um bar ou de uma rua para uma praia, com outra roupa e outra luz, mantendo o rosto.
Duas pessoas numa cena
Reúna pessoas de retratos separados num só quadro, para uma foto de casal ou uma dupla de personagens.
Nova iluminação e mudança de cor
Peça uma nova fonte de luz com uma cor hexadecimal e mantenha o resto da composição.
Guia de prompt e dicas práticas
Diga o que fica
Comece com "mesmo homem, mesmo rosto e mesma barba" e depois liste o que muda. Listas curtas e explícitas funcionam melhor que descrições longas.
Numere as pessoas
Ao combinar fotos, escreva "a mulher da imagem 1 e o homem da imagem 2" e peça para manter os dois rostos exatamente como nas fotos.
Uma pessoa por quadro, quando importa
Acrescente "sozinho no quadro, sem outras pessoas" para evitar que figuras extras apareçam ao fundo.
Comece com auto
Deixe primeiro o formato em auto. Escolha uma proporção e o 2k quando gostar do conteúdo, e mantenha a seed para comparar a versão maior.
Use origens nítidas
Fotos bem iluminadas e de frente passam melhor os rostos. A segunda e a terceira pessoa são um pouco menos estáveis que a primeira.
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-dev/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.
























