Introdução
FLUX.1 Fill Dev LoRA Inpainting redesenha a parte mascarada de uma imagem com o FLUX.1 Fill [dev], o modelo de preenchimento de 12 bilhões de parâmetros da Black Forest Labs, com até três arquivos LoRA seus carregados. O branco da máscara é repintado conforme o seu prompt; o preto volta como estava. A plataforma não acrescenta nenhum filtro de conteúdo ao prompt, aos pesos nem à imagem.
Recursos e destaques
O resto da imagem permanece
Nos nossos testes, a área sem máscara voltou intacta e uma máscara toda preta devolveu a foto sem alterações, então um rosto, um ambiente ou uma foto de produto sobrevivem à edição.
Preenchimentos que combinam com a luz
O modelo foi treinado para se misturar ao entorno: um vestido de seda captou a luz de tungstênio de um ateliê e um moletom a luz baixa do sol de um estúdio, sem nenhum prompt extra.
Seus LoRAs dentro da máscara
Até três LoRAs de FLUX.1 dev carregam por requisição. Um LoRA de pixel art transformou uma parede mascarada em um mural; um LoRA sem filtro entregou o que o modelo base tinha suavizado.
Até quatro versões por execução
Peça de uma a quatro imagens na mesma máscara e escolha o melhor preenchimento, cobrado por imagem.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva o que entra na área branca: o objeto ou a peça de roupa, o material e a luz em que ele está. Coloque primeiro a frase-gatilho do LoRA. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_url | Sim | A foto a repintar. O resultado mantém a proporção dela; o nível de resolução define o lado maior. |
mask_url | Sim | Uma imagem em preto e branco do mesmo tamanho da origem: o branco é redesenhado, o preto é mantido. |
resolution | Não | 1k devolve um lado maior de 1024 pixels e é o padrão; 1.5k devolve 1536. Os lados são arredondados para baixo até um múltiplo de 32. |
num_outputs | Não | Quantas versões gerar da mesma máscara, de 1 a 4; padrão 1. Cada imagem é cobrada, então quatro imagens custam quatro vezes uma. |
loras | Não | Até três entradas {path, scale} treinadas para o FLUX.1 dev; scale de 0 a 4, sendo 1 o neutro. Use um link direto público para o arquivo .safetensors. Valor padrão: |
guidance_scale | Não | O quanto o preenchimento segue o prompt à risca, de 28 a 35; padrão 30. Não muda o preço. |
steps | Não | Passos de remoção de ruído, de 1 a 50; padrão 28. Menos passos voltam mais rápido e um pouco mais suaves. |
seed | Não | Mantém os preenchimentos comparáveis enquanto você muda o prompt ou um LoRA. Não garante os mesmos pixels em toda execução. |
Preços
$0.042 / imagem
Cobrado por imagem: uma execução com quatro imagens custa quatro vezes uma. O nível de resolução e o carregamento de LoRAs não mudam o preço.
Casos de uso
Moda e trocas de figurino
Mude uma peça, uma cor ou um decote numa foto pronta, mantendo a modelo, a pose e o cenário exatamente como na foto.
Retoque
Repinte uma mão, remova um objeto ou troque um elemento do fundo mascarando só essa região.
Arte dentro de uma cena
Mascare uma parede, uma tela ou uma folha de papel e pinte nela um mural ou um esboço com um LoRA de estilo.
Guia de prompt e dicas práticas
Descreva a área branca
Escreva o que entra na máscara e como está iluminado: "a floor-length crimson silk slip dress with thin straps, catching warm tungsten light". Não é preciso descrever de novo o resto da foto.
Mascare com folga
Inclua alças, golas, capuzes e reflexos em espelhos de tudo o que você mudar. O que ficar fora da máscara permanece na imagem.
Mantenha a máscara no canvas da origem
Exporte a máscara no mesmo tamanho da foto. Uma máscara de outro tamanho é esticada, e isso desloca a área branca.
Peça várias versões
Os preenchimentos variam com a seed. De duas a quatro imagens por execução é o caminho mais rápido para uma borda limpa.
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-1-fill-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"mask_url": "https://example.com/reference.png",
"num_outputs": 1,
"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.
