Introdução
FLUX 3 Klein Edição de imagem muda uma a três imagens de referência que você envia no FLUX 3 Klein, o modelo de 5,6 bilhões de parâmetros de pesos abertos lançado em outubro de 2026, na versão destilada em poucos passos. Escolha 1k ou 2k e uma de quinze proporções, receba um JPEG, PNG ou WebP e pague por imagem. A plataforma não acrescenta nenhum filtro de conteúdo.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX 3 Klein Texto para imagem |
| uma a três imagens para mudar | FLUX 3 Klein Edição de imagem |
Recursos e destaques
Nomeie cada origem
Escreva <ref_image_1>, <ref_image_2> e <ref_image_3> no prompt, na ordem do upload, a notação que a Black Forest Labs documenta para este modelo. Nos nossos testes, uma peça de roupa ou um chapéu de uma foto foi para uma pessoa de outra, com o rosto mantido.
Sem filtro de conteúdo
Prompts, origens e resultados não são revisados. Em nossos testes, retratos sem filtro de mulheres adultas passaram e edições sem filtro foram feitas conforme pedido; apenas os pedidos mais fortes foram suavizados pelo próprio modelo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 5.000 caracteres. Nomeie as origens como < |
image_urls | Sim | Obrigatório, de um a três links públicos de imagem, de até 10 MB cada, na ordem em que o prompt se refere a elas. Um link que não abre ou que não é imagem faz a requisição falhar. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) mantém o formato da primeira imagem, por exemplo 880 x 1184 em 1k para uma origem em retrato; ou escolha um dos quinze formatos de 3:1 a 1:3. Não muda o preço. |
resolution | Não | 1k (padrão) tem cerca de um megapixel; 2k tem cerca de quatro, por exemplo 1760 x 2368 para uma origem em retrato. O 2k custa mais. |
output_format | Não | jpeg (padrão), png ou webp. Mesmo preço para os três. |
seed | Não | Opcional, de 0 a 2147483647. Reutilize-a para comparar redações sobre as mesmas origens. |
Preços
Cobrado por imagem conforme o nível de tamanho (1k ou 2k); cada imagem de referência depois da primeira soma uma pequena cobrança. Proporção e formato do arquivo não mudam o preço.
| Especificação | Preço |
|---|---|
| $0.0192 / imagem |
| $0.0768 / imagem |
Casos de uso
Trocas de roupa e de adereços
Leve um vestido, chapéu ou jaqueta de uma foto de produto para uma pessoa de outra foto, num só pedido.
Mudança de luz e de estilo
Transforme a manhã em pôr do sol ou o meio-dia em hora azul, enquanto o rosto e o ambiente ficam.
Guia de prompt e dicas práticas
Escreva uma legenda completa
Descreva enquadramento, sujeito, roupa, lugar, luz e lente em frases completas. Não há prompt negativo, então diga o que você quer, e não o que quer evitar.
Liste o que fica
Ao lado da mudança, nomeie o que não pode se mexer: rosto, cabelo, pose, o ambiente. Sem isso, o modelo fica livre para reinterpretar o quadro inteiro.
Rascunhe em 1k, finalize em 2k
Fixe a seed enquanto trabalha em 1k, depois rode as mesmas entradas em 2k para a imagem final.
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/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.


























