Introdução
FLUX 3 Klein Base Edição de imagem muda ou combina uma a três imagens de origem a partir de uma instrução escrita no FLUX 3 Image Klein Base da Black Forest Labs, o checkpoint de 5.6B não destilado. Refira-se às origens como image 1, image 2 e image 3, mantenha o formato da primeira imagem com auto ou escolha um entre quinze, e escolha 1k ou 2k. As edições levaram cerca de 20 a 40 segundos em 1k nos nossos testes, e nada é filtrado.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX 3 Klein Base Texto para imagem |
| uma a três imagens para mudar ou combinar | FLUX 3 Klein Base Edição de imagem |
Recursos e destaques
Roupas de uma foto de produto
Dê a pessoa como image 1 e uma peça fotografada num cabide como image 2, e a edição veste uma com a outra. Nos nossos testes, uma mulher de parka de inverno voltou de vestido de veludo bordô num vestiário de sauna, com rosto e cabelo mantidos.
Mesma pessoa, lugar novo
Rosto, barba e corpo se mantiveram numa troca completa de roupa e de cenário: um trilheiro de jaqueta vermelha numa floresta nevada virou o mesmo homem, de camisa de linho aberta, num banco de cedro. Instruções curtas e concretas mantiveram os rostos melhor.
Combine até três imagens
Duas fotos separadas de duas mulheres viraram uma cena num banco de sauna, de vestidos iguais, com os dois rostos reconhecíveis. Com três origens, diga o que cada uma traz para que nada se perca.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 5.000 caracteres. Diga primeiro o que deve ficar (rosto, cabelo, corpo) e depois a mudança. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | Obrigatório, de uma a três links públicos de imagem, de até 10 MB cada. Um link que não abre ou não é uma imagem faz a requisição falhar, sem cobrança. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) mantém o formato da primeira origem: um retrato de 880 x 1184 saiu como 880 x 1184 em 1k e 1760 x 2368 em 2k. Ou escolha um dos quinze formatos de 3:1 a 1:3. |
resolution | Não | 1k (padrão) ou 2k, também aplicado com auto. O 2k custa cerca de quatro vezes o 1k na saída e o dobro por origem. |
output_format | Não | JPEG (padrão), PNG ou WebP. Não muda o preço. |
seed | Não | Opcional, de 0 a 2147483647. Reutilize-a para comparar mudanças na instrução; edições repetidas voltaram parecidas, mas nem sempre idênticas em pixel. |
Preços
Cobrado por imagem: uma taxa pelo nível de tamanho de saída e uma taxa por cada imagem de origem, ambas maiores em 2k. A proporção e o formato de saída não mudam o preço.
| Especificação | Preço |
|---|---|
| $0.054 / imagem |
| $0.216 / imagem |
Casos de uso
Lookbooks e styling
Coloque uma peça de uma foto de produto numa pessoa de outra foto, em um lugar e uma luz novos, para lookbooks e painéis de referência.
Trocas de cenário e de roupa
Leve uma pessoa a um cenário e um figurino novos num só passo, mantendo quem ela é, para fichas de personagem e séries.
Guia de prompt e dicas práticas
Use os números das imagens
Escreva image 1, image 2 e image 3 na ordem de envio e dê a cada uma um papel: a mulher da image 1, o vestido da image 2. A primeira imagem também define o formato quando a proporção está em auto.
Proteja primeiro, depois mude
Comece pelo que deve continuar igual, como rosto, cabelo e corpo, e depois descreva a mudança: peça, lugar, pose e luz. O modelo pode deixar a roupa no lugar, então diga exatamente o que a pessoa deve vestir.
Cuidado com o preço por origem
Cada origem soma ao preço, e o 2k dobra essa cobrança. Use uma origem quando uma bastar e rascunhe em 1k.
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-3-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"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.


























