Introdução
Krea 3 Edição de imagem altera ou combina de uma a oito imagens de origem a partir de uma instrução em linguagem simples. A Krea criou o Krea 3 pensando primeiro em edições: diga o que deve mudar e o que deve permanecer, e refira-se às origens como image 1, image 2 e assim por diante. Você define o formato da saída; cada resultado tem cerca de um megapixel.
Escolha um modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | Krea 3 Texto para imagem |
| de uma a oito fotos para alterar ou combinar | Krea 3 Edição de imagem |
Recursos e destaques
Combine pessoas, roupas e lugares
Até oito origens numa mesma requisição. No nosso exemplo, a mulher da image 1 veste o vestido de estampa paisley da image 2 num deque de cânion, com rosto e cabelo preservados.
Nomeie as origens pelo número
“A pessoa da image 2” escolhe o segundo upload: no nosso teste, com uma mulher como image 1 e um homem como image 2, apareceu apenas o homem.
A identidade se mantém em grandes mudanças
Uma mulher de blazer de escritório virou um retrato dos anos 1970 numa salinha revestida de madeira, com o mesmo rosto, tranças e enquadramento.
Só conteúdo no nível de moda
As requisições e as origens passam por triagem. Mudanças de roupa e de cenário foram aceitas; pedidos para tirar a roupa foram recusados e não cobrados.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que mudar e depois o que permanece. Refira-se às origens como image 1, image 2, na ordem de upload. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a oito imagens, na ordem em que o prompt as cita. Cada uma soma o preço da saída novamente. pelo menos 1 itens · no máximo 8 itens |
aspect_ratio | Não | Formato da saída: 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 ou 21:9. Padrão 1:1; o formato da origem não é mantido automaticamente. |
quality | Não | high (padrão) prioriza o detalhe; fast retorna mais cedo. Mesmo preço. |
enable_thinking | Não | Planeja um prompt mais longo antes de desenhar; cerca de duas vezes mais lento nos nossos testes. Desligado por padrão. Valor padrão: |
negative_prompt | Não | O que deixar de fora, até 1.024 caracteres. Usado somente pela variante de alta qualidade. no máximo 1024 caracteres |
output_format | Não | PNG (padrão) ou JPEG. Sem efeito no preço. |
seed | Não | Opcional, de 0 a 2147483647. Reutilizar uma seed aproxima você de uma imagem anterior, mas não garante correspondência. |
Preços
$0.072 / imagem
Cobrado por imagem: um preço de saída mais o mesmo valor para cada imagem de origem. Variante de qualidade, raciocínio e proporção não mudam o preço. Requisições recusadas não são cobradas.
Casos de uso
Provador virtual e styling
Um retrato mais a foto de produto de uma peça vira uma imagem estilizada dessa pessoa vestindo a roupa.
Recontextualização e looks de época
Leve um sujeito para um novo lugar, época ou luz, mantendo quem ele é.
Guia de prompt e dicas práticas
Comece pela mudança
Diga primeiro o que deve mudar, depois uma frase sobre o que permanece. Para várias origens, nomeie cada uma: “a mulher da image 1”, “o vestido da image 2”.
Escolha o formato da saída
O resultado usa a proporção que você escolher, e não o formato da origem. Combine a proporção com a foto principal para evitar cortes indesejados.
Atenção à quantidade de origens
Cada imagem de origem é cobrada além da saída, então envie só as que o prompt usa. Informe a idade das pessoas ao mudar a época ou o estilo; os looks podem ficar mais jovens ou mais velhos.
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": "krea/3/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high"
}
}'
# 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.










