Introdução
O FLUX.2 [pro] Edição executa o FLUX.2 [pro] da Black Forest Labs em imagens que você já tem. Ele aceita de uma a três origens, aplica a mudança que você descreve e devolve 1k ou 2k no formato da origem ou em um de nove formatos.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX.2 [pro] Texto para imagem |
| de uma a três imagens para alterar ou combinar | FLUX.2 [pro] Edição |
Recursos e destaques
Composições com várias referências
Combine uma pessoa, um produto e um lugar de fotos separadas. No nosso anúncio de fones, o rosto, o cabelo e o cardigã e o design dos fones permaneceram como nas origens.
Mudanças de cena e de luz
Troque o cenário ou reilumine uma foto mantendo o sujeito no lugar. Nossa rua ensolarada virou uma noite chuvosa de neon, com gotas de chuva no blazer.
Texto acrescentado na edição
Acrescente um título à imagem na mesma etapa. O nosso saiu escrito como no prompt.
Preço fixo por imagem
Uma origem ou três, 1k ou 2k: a edição custa o mesmo.
Rigoroso com pessoas
Em nossos testes, fontes de retrato foram recusadas mesmo para uma troca de roupa de nível Leve. Pedidos recusados não são cobrados.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 5.000 caracteres. Diga o que mudar e o que deve permanecer igual, e chame as origens de imagem 1, imagem 2 e imagem 3, na ordem de envio. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | Obrigatório, de uma a três imagens de origem, de até 10 MB cada. Envie-as na ordem em que o prompt as cita. 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. Vale apenas quando você escolhe um formato; com auto, o resultado fica em cerca de um megapixel. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o enquanto muda o prompt para comparar variações; ele não garante uma imagem idêntica. |
Preços
$0.058 / imagem
Cobrado com um preço fixo por imagem, seja qual for o número de origens ou o nível de tamanho. Pedidos recusados e com falha não são cobrados.
Casos de uso
Anúncios a partir de materiais separados
Reúna uma foto de modelo, uma foto de produto e um local em um único visual.
Variações de clima
Mostre a mesma cena de dia, à noite ou na chuva para um cliente que escolhe a direção.
Novo visual para produtos e lugares
Altere o fundo, a luz ou o estilo de um produto, de um ambiente ou de um retrato.
Guia de prompt e dicas práticas
Numere as origens
Diga que a imagem 1 é a pessoa, a imagem 2 o produto e a imagem 3 o lugar, na ordem de envio.
Nomeie o que deve permanecer
Depois da mudança, liste o rosto, o look, a pose ou o design que precisa continuar exatamente como estava.
Mude uma coisa por vez
Uma única mudança clara mantém estável o resto do quadro; encadeie edições em vez de reunir várias em uma só.
Reserve tempo
As edições levaram de 45 a 120 segundos nos nossos testes.
Mantenha-o adequado para o trabalho
Este modelo é rigoroso com pessoas, então use-o para produtos, lugares e retratos adequados para o trabalho.
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-pro/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.
























