Skip to main content
O Krea 3 é um modelo rápido de edição de imagens. Ele segue instruções em linguagem natural: você diz o que deve mudar e o que deve continuar igual, e o Krea 3 gera a edição em segundos. Você também pode usá-lo para gerar imagens a partir de texto.
A API do Krea 3 está em acesso antecipado. Somente workspaces que participam do beta do Krea 3 podem chamá-la. Para solicitar acesso, entre em contato com sales@krea.ai.

Endpoint

O endpoint segue o ciclo de vida do job padrão: ele retorna um job_id, e você faz polling em GET /jobs/{job_id} (ou usa um webhook) até o job ser concluído. A imagem gerada fica em result.urls[0].

Início rápido: sua primeira edição de imagem

Todas as requisições exigem um Bearer token. Veja Chaves de API e cobrança se você ainda não tiver um.
1

Envie uma referência

Faça POST /assets com sua imagem de entrada. A resposta retorna image_url. Você também pode passar uma URL de imagem externa ou um data URI em base64 diretamente em image_urls.
2

Crie uma edição

Faça POST /generate/image/krea/krea-3 com seu prompt e sua referência. Guarde o job_id da resposta.
3

Obtenha o resultado

Faça polling em GET /jobs/{job_id} até que status seja completed. O resultado fica em result.urls[0].
Mantenha seu token de API no seu servidor. Nunca o inclua em código do lado do cliente.

Parâmetros

Com width e height, o resultado é arredondado para a proporção compatível mais próxima e para uma tela de 1k ou 2k. Dimensões exatas em pixels não são garantidas.Reutilizar uma seed não garante resultados idênticos, porque a etapa de expansão do prompt pode variar entre execuções.

Modos de raciocínio

Antes de gerar, o Krea 3 interpreta seu prompt. O thinking_mode define quanto planejamento ele faz. Se você omitir thinking_mode, a API usa fast. Os dois modos são compatíveis com regional_edit.

Edições regionais

Com regional_edit: true, o Krea 3 regenera apenas as partes da imagem que precisam mudar. Todo o resto permanece exatamente como estava, então você pode editar a mesma imagem várias vezes sem perder qualidade. Use para edições locais em que o restante da imagem precisa continuar idêntico pixel a pixel: mudar a cor de um objeto ou trocá-lo, adicionar ou remover um elemento, corrigir um detalhe ou alterar o texto de uma placa. É a forma segura de encadear edições sobre o resultado mais recente. Não use para edições globais que devem renderizar a imagem inteira novamente: mudar o estilo ou a iluminação, mudar a estação ou o horário do dia, reenquadrar ou combinar várias imagens em uma nova cena. Edições normais renderizam a imagem inteira novamente, então artefatos podem se acumular quando você continua editando o resultado mais recente. Edições regionais exigem pelo menos uma imagem em image_urls.

Prompts

O Krea 3 é um editor que segue instruções. Escreva a edição em linguagem natural:
  • Comece pela mudança. Adicione apenas os detalhes que ajudam a executá-la.
  • Termine com uma frase de preservação quando o restante da imagem deve continuar igual. Não liste tudo o que deve permanecer igual.
  • Quando o prompt usar mais de uma imagem, refira-se a cada imagem pelo que ela mostra. Por exemplo: “Coloque o tênis da segunda imagem na pessoa da primeira imagem.”

Referências de imagem

  • O Krea 3 usa cada referência na resolução em que foi enviada. Uma referência maior que 4 MP é redimensionada para 4 MP.
  • Cerca de 1 MP é suficiente para a maioria das edições. Não faça upscale de uma referência antes de enviá-la.
  • Quando detalhes finos importam (texto pequeno, logotipos, tecidos, rostos em um plano aberto), envie a versão da imagem com a maior resolução que você tiver.
  • Com cinco ou mais referências em uma requisição, cada referência é redimensionada para no máximo 1536 px no lado maior. Para referências com todos os detalhes, envie quatro ou menos.

Zero Data Retention

O Krea 3 é compatível com Zero Data Retention para workspaces enterprise. Envie o cabeçalho X-Api-Zero-Data-Retention: 1. Com o Zero Data Retention:
  • Toda imagem em image_urls precisa ser um data URI em base64.
  • thinking_mode pode ser fast ou high.
  • Uma requisição pode usar no máximo 4 referências de imagem.

Preços

O preço por imagem depende da resolução de saída, do modo de raciocínio e das referências de imagem.

Relacionados

Ciclo de vida do job

Status de jobs, polling e resultados.

Webhooks

Receba uma notificação quando um job for concluído, em vez de fazer polling.