Introdução
Envie uma imagem de origem e descreva o resultado. A intensidade decide o quanto a saída se afasta da origem; com uma máscara em preto e branco, só a área branca é redesenhada e o resto fica como estava. Dá para carregar até três arquivos LoRA treinados para o FLUX.1 [dev], o preço por imagem é fixo e nada é filtrado.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Endpoints | Texto para imagem e edição de imagem (intensidade, máscara opcional de inpainting), ambos com suporte a LoRA |
| Modelo base | FLUX.1 [dev], o rectified flow transformer de 12 bilhões de parâmetros da Black Forest Labs |
| Entrada de LoRA | Até 3 entradas, cada uma {path, scale}; path é uma URL HTTPS direta para um arquivo .safetensors |
| Força do LoRA | De 0 a 4 por entrada (padrão 1) |
| Guidance | De 0 a 20 (padrão 3,5) |
| Tamanho da saída | Cerca de um megapixel: 1024 x 1024 em 1:1, 1344 x 768 em 16:9, 1536 x 640 em 21:9 |
| Proporções | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 |
| Formatos de saída | JPEG (padrão), PNG, WebP |
Recursos e destaques
Fotografias, não renders
Um LoRA Super Realism e uma mesa de lanchonete tarde da noite junto a uma janela com chuva: dois homens inclinados um para o outro sob uma luminária pendente quente. Pele, tecido e luz da janela parecem de fotografia.
Um visual de revista com um só gatilho
"MJ v6" e um LoRA de estilo Midjourney dão ao FLUX um acabamento editorial lustroso: um vestido de gala de cetim vermelho com as costas de fora numa escadaria de mármore, com luz lateral.
Troque a linguagem inteira
Um LoRA de desenho animado de membros alongados em 1,2 transforma o mesmo modelo num ilustrador de pin-up: um guarda-chuva vermelho, uma rua de paralelepípedos molhada e proporções exageradas.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva a imagem inteira que você quer receber. Com máscara, descreva o que deve aparecer na área branca. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_url | Sim | A imagem a editar. O resultado mantém o formato dela com cerca de 0,7 megapixel: nos nossos testes, uma origem de 1024 x 1536 voltou com 672 x 1008. |
mask_url | Não | Opcional. Uma imagem em preto e branco do mesmo tamanho da origem: as áreas brancas são redesenhadas pelo prompt e as pretas ficam como estão. |
strength | Não | O quanto se afastar da origem, de 0 a 1 (padrão 0,8). Com máscara, use de 0,9 a 1 para a área branca mudar de verdade. |
loras | Não | Até três entradas {path, scale} treinadas para o FLUX.1 [dev]; scale de 0 a 4, 1 é neutro. Use um link direto público para o arquivo .safetensors. Valor padrão: |
guidance_scale | Não | O quanto o resultado segue o prompt, de 0 a 20 (padrão 3,5). LoRAs de realismo costumam ficar mais naturais um pouco abaixo. |
steps | Não | Passos de remoção de ruído, de 1 a 50 (padrão 28). Mais passos levam mais tempo para gerar. |
output_format | Não | JPEG por padrão, PNG ou WebP se você precisar. Não muda o preço. |
seed | Não | Mantém os resultados comparáveis enquanto você ajusta a intensidade ou a máscara; a mesma seed não garante uma imagem idêntica. |
Preços
$0.018 / imagem
Cobrado por imagem a um preço fixo. Máscara, intensidade, passos e LoRAs não têm custo à parte.
Casos de uso
O LoRA que você já encontrou
Se o visual que você quer está no Hugging Face ou num hub da comunidade como um LoRA de FLUX, é aqui que ele roda como uma simples chamada de API: cole o link do arquivo, defina o scale e escreva o prompt.
Imagens de moda e editoriais
LoRAs de realismo e de estilo revista entregam vestidos de gala com as costas de fora em escadarias de mármore e mesas de lanchonete tarde da noite junto a janelas com chuva, com luz e pele convincentes.
Campanhas estilizadas
LoRAs de desenho animado, pin-up e ilustração transformam um único modelo de prompt numa série consistente em nove proporções.
Imagens sem censura
Os LoRAs sem filtro são carregados sem revisão e o resultado não é filtrado, para plataformas cujos usuários esperam essa liberdade.
Guia de prompt e dicas práticas
Descubra o gatilho do LoRA
A maioria dos LoRAs de FLUX indica uma frase-gatilho na página do modelo, como "Super Realism" ou "MJ v6". Coloque-a no começo do prompt e depois descreva a imagem.
Ajuste o guidance com LoRAs de realismo
O guidance padrão é 3,5. LoRAs de realismo costumam ficar mais naturais entre 2 e 3,5; valores muito altos puxam para um visual lustroso e com nitidez exagerada.
Suba o scale em estilos fortes
Alguns LoRAs de estilo precisam de um scale acima de 1 para assumir o controle. Nosso exemplo de desenho animado rodou em 1,2; comece em 1 e ajuste em passos de 0,2.
Confira se o arquivo é público
Use um link direto que baixe o arquivo .safetensors. Repositórios restritos respondem com HTTP 401, e a requisição falha antes de qualquer imagem ser gerada.
Introdução
FLUX.1 Dev LoRA Edição de imagem muda uma imagem de origem no FLUX.1 [dev] da Black Forest Labs, guiada pelo seu prompt e por até três arquivos LoRA seus. Sem máscara, muda o estilo do quadro inteiro, e uma intensidade de 0 a 1 decide o quanto se afasta da origem. Com uma máscara em preto e branco, redesenha só a área branca e mantém o resto. O resultado volta em JPEG, PNG ou WebP a um preço fixo, e nada é filtrado.
Escolha o modo pelo material
| O que você tem | Modo |
|---|---|
| uma imagem para mudar, inteira ou em parte | FLUX.1 Dev LoRA Edição de imagem |
| só uma descrição escrita | FLUX.1 Dev LoRA Texto para imagem |
Recursos e destaques
Inpainting com máscara
Pinte de branco a área a mudar e de preto todo o resto. Em nossos testes, uma máscara sobre a parte superior do corpo de um retrato de estúdio mudou apenas essa área, enquanto o rosto, o cabelo e a calça permaneceram como estavam.
Uma intensidade fácil de entender
O padrão 0,8 mantém a pose e a composição; 0,95 deixa o modelo redesenhar quase tudo, inclusive o rosto. Com máscara, de 0,9 a 1 garante que a área branca mude de verdade.
Sem censura, com pesos próprios
A origem, o prompt, os pesos e o resultado nunca são filtrados. Com força 0,95, um retrato de estúdio foi editado como pedia nosso teste mais forte, com e sem um LoRA sem filtro.
Casos de uso
Mudar uma parte de uma foto
Troque uma roupa, um fundo ou um objeto e mantenha o restante da imagem intacto, para variações de produto, testes de guarda-roupa ou retoque de retratos.
Mudar o estilo com um LoRA da comunidade
Passe uma foto por um dos mais de mil LoRAs de FLUX para dar a ela cara de filme, brilho editorial ou traço de ilustração sem mexer na composição.
Guia de prompts e dicas
Descreva o resultado, não a instrução
Escreva o que a imagem final deve conter. Com uma máscara, descreva apenas o que deve ir na área branca, como «um top de veludo preto, luz suave de estúdio».
Suavize as bordas duras da máscara
Um retângulo duro deixa uma costura visível onde encontra os pixels mantidos. Suavize a borda da máscara ou siga o contorno do objeto que você quer trocar.
Comece em 0,8 e ande de 0,05 em 0,05
Se a origem aparecer demais, aumente a intensidade; se o rosto mudar, diminua. Mantenha a seed fixa enquanto compara para que só a intensidade mude.
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-dev-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"
}
}'
# 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.
