Introdução
FLUX.2 [klein] 9B Edição é o modo de edição do modelo de imagem pequeno e rápido da Black Forest Labs, lançado em 15 de janeiro de 2026. Aceita de uma a três imagens de origem e uma instrução, devolve um JPEG com cerca de um megapixel ou no nível 1k ou 2k que você escolher, e não tem filtro de conteúdo.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | FLUX.2 Klein 9B Texto para imagem |
| imagens para mudar | FLUX.2 Klein 9B Edição |
Recursos e destaques
A mesma pessoa, um visual novo
Nos nossos testes, o rosto, o cabelo e a pose se mantiveram em trocas de roupa e de fundo. Liste o que deve ficar e depois descreva a mudança.
Redimensione enquanto edita
Escolha um formato e um nível de tamanho, e a edição volta com 2048 pixels no lado maior. Com auto, mantém o formato da origem.
Um preço fixo
Uma edição custa o mesmo com uma origem ou com três, em 1k ou 2k.
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 continuar igual, por exemplo rosto, cabelo e pose, e nomeie as novas peças de roupa. 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, na ordem em que o prompt se refere a elas. O número de imagens não muda o preço. 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 dos nove formatos, de 21:9 a 9:21. O formato não muda o preço. |
resolution | Não | 1k (padrão) ou 2k, usado apenas quando você escolhe uma proporção; com auto, o resultado fica em cerca de um megapixel. Não muda o preço. |
seed | Não | Número inteiro opcional de 0 a 2147483647. Reutilize-o para comparar mudanças no prompt lado a lado; deixe vazio para uma aleatória. |
Preços
$0.016 / imagem
Um preço fixo por imagem, seja qual for o número de imagens de origem e o tamanho, 1k ou 2k. Requisições com falha ou recusadas não são cobradas.
Casos de uso
Trocas de roupa e de cena
Mude a roupa, o ambiente ou a hora do dia mantendo as pessoas reconhecíveis.
Variações rápidas de uma foto
Vários climas de uma mesma imagem no tempo de um café.
Combinação de até três origens
Uma pessoa, um lugar e um objeto reunidos num só quadro, cada um indicado no prompt.
Guia de prompt e dicas práticas
Diga o que fica
Rosto, cabelo, pose, lugar. Depois descreva a mudança em uma ou duas frases.
Nomeie as novas peças de roupa
Diga o corte e o tecido que você quer; nos nossos testes, a edição seguiu as peças de roupa citadas no prompt.
Mude uma coisa de cada vez
Para transformações maiores, encadeie duas edições.
Escolha um formato para o 2k
Auto dá cerca de um megapixel; escolha um formato se quiser o nível 2k.
Confira mãos e rostos
Modelos pequenos podem falhar em ambos. Tente outra seed se isso acontecer.
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-klein-9b/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.
























