Introdução
FLUX.1 Schnell LoRA Edição de imagem redesenha uma imagem de origem no FLUX.1 [schnell], o modelo FLUX rápido e Apache-2.0 da Black Forest Labs, com até três arquivos LoRA seus carregados. Um controle de strength define o quanto o resultado se afasta da origem, uma máscara opcional limita a mudança a uma área, e a saída mantém a proporção da origem. A plataforma não acrescenta nenhum filtro de conteúdo ao prompt, aos pesos nem à imagem.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX.1 Schnell LoRA Texto para imagem |
| uma imagem para mudar de estilo ou preencher com inpainting | FLUX.1 Schnell LoRA Edição de imagem |
Recursos e destaques
Inpainting de verdade com máscara
Envie uma máscara em preto e branco e só a área branca é redesenhada. No nosso teste, um trench coat virou um robe de cetim vermelho, enquanto o rosto, o cabelo e a academia ao fundo ficaram exatamente como estavam.
Edições do quadro inteiro com um seletor de strength
Sem máscara, o quadro inteiro é redesenhado. Strength de 0,8 a 0,9 manteve o enquadramento e a pose enquanto mudava a roupa e o cenário.
LoRAs nas edições
LoRAs de FLUX.1 [dev] também carregam na edição, até três ao mesmo tempo, cada um com scale de 0 a 4.
Sem filtro de conteúdo
As imagens de origem podem ser redesenhadas com qualquer prompt, dentro de uma máscara ou no quadro inteiro. Nada é filtrado na entrada nem na saída.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Com máscara, descreva só o que vai na área branca. Sem ela, descreva a imagem inteira, incluindo quem aparece nela. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_url | Sim | A imagem a editar. O resultado mantém a proporção dela; o nível de resolução define o lado maior. |
mask_url | Não | Máscara opcional em preto e branco do tamanho da origem: as áreas brancas são redesenhadas e as pretas são mantidas. |
resolution | Não | 1k devolve um lado maior de cerca de 1.000 pixels e é o padrão; 1.5k, cerca de 1.500. Os dois custam o mesmo, e a proporção sempre segue a origem. |
strength | Não | O quanto se afastar da origem, de 0 a 1; 0,8 por padrão. |
loras | Não | Até três entradas {path, scale} treinadas para o FLUX.1 [dev] ou o FLUX.1 [schnell]; scale de 0 a 4, sendo 1 o padrão. Os LoRAs também valem dentro da máscara e não mudam o preço. Valor padrão: |
output_format | Não | JPEG por padrão, ou PNG ou WebP. O formato não muda o preço. |
seed | Não | Mantém os resultados comparáveis enquanto você ajusta a strength ou a máscara. Sem seed, ela é aleatória. |
Preços
$0.006 / imagem
Cobrado por imagem, à mesma tarifa do texto para imagem. Uma máscara, o nível de resolução, o formato de saída e o carregamento de LoRAs não alteram o preço.
Casos de uso
Trocar uma peça de roupa
Mascare a roupa, descreva a peça nova e mantenha a pessoa e o ambiente intocados.
Dar novo estilo a um ensaio
Rode um conjunto de fotos com strength de 0,8 a 0,9, o mesmo prompt e o mesmo LoRA para obter roupas ou cenários novos e coerentes.
Variações rápidas
Mantenha a origem e o prompt, mude a seed e obtenha tomadas alternativas em segundos.
Guia de prompt e dicas práticas
Ajuste a máscara ao objeto
Um retângulo duro que cortou o cabelo deixou uma emenda visível no nosso teste. Uma máscara que seguia a roupa se misturou sem marcas.
Com máscara, descreva só a área mascarada
"A red satin boxing robe slipping off one shoulder" basta; o resto da imagem é mantido da origem.
Sem máscara, descreva a pessoa
Acima de strength 0,85 os rostos se afastam do original. Repetir quem está na imagem os manteve reconhecíveis nos nossos testes.
Escolha a strength pela tarefa
0,5 quase não muda a foto, perto de 0,7 os detalhes mudam, de 0,85 a 0,9 é uma roupa nova no mesmo enquadramento, e 1 é uma imagem nova. Com máscara, use de 0,9 a 1.
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-schnell-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"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.
