Skip to main content
O Krea 3 é um modelo rápido de edição de imagens. Segue instruções em linguagem natural: indica o que deve mudar e o que deve manter-se igual, e o Krea 3 produz a edição em segundos. Também o pode utilizar para gerar imagens a partir de texto.
A API do Krea 3 está em acesso antecipado. Apenas os workspaces incluídos na beta do Krea 3 a podem chamar. Para pedir acesso, contacte sales@krea.ai.

Endpoint

O endpoint segue o ciclo de vida das tarefas padrão: devolve um job_id e faz polling de GET /jobs/{job_id} (ou utiliza um webhook) até a tarefa ser concluída. A imagem resultante está em result.urls[0].

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

Todos os pedidos requerem um token Bearer. Consulte Chaves de API e Faturação se ainda não tiver um.
1

Carregue uma referência

Faça POST /assets com a sua imagem de entrada. A resposta devolve image_url. Também pode passar diretamente em image_urls um URL de imagem externo ou um data URI em base64.
2

Crie uma edição

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

Obtenha o resultado

Faça polling de GET /jobs/{job_id} até status ser completed. O resultado está em result.urls[0].
Mantenha o 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 suportada mais próxima e para uma tela de 1k ou 2k. Não são garantidas dimensões exatas em píxeis.Reutilizar uma seed não garante resultados idênticos, porque o passo de expansão do prompt pode variar entre execuções.

Modos de raciocínio

Antes de gerar, o Krea 3 interpreta o seu prompt. O thinking_mode define o grau de planeamento que realiza. Se omitir thinking_mode, a API utiliza fast. Ambos os modos suportam regional_edit.

Edições regionais

Com regional_edit: true, o Krea 3 regenera apenas as partes da imagem que precisam de mudar. Tudo o resto fica exatamente como estava, pelo que pode editar a mesma imagem vezes sem conta sem perda de qualidade. Utilize-o para edições locais em que o resto da imagem tem de se manter idêntico ao píxel: mudar a cor de um objeto ou substituí-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 o utilize para edições globais que devam renderizar novamente a imagem inteira: mudar o estilo ou a iluminação, mudar a estação do ano ou a hora do dia, reenquadrar ou combinar várias imagens numa nova cena. As edições normais renderizam novamente a imagem inteira, pelo que podem acumular-se artefactos quando continua a editar o resultado mais recente. As edições regionais requerem 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 alteração. Acrescente apenas os detalhes que ajudam a executá-la.
  • Termine com uma frase de preservação quando o resto da imagem deve manter-se igual. Não enumere tudo o que deve manter-se igual.
  • Quando o prompt utilizar mais de uma imagem, refira-se a cada imagem pelo que mostra. Por exemplo: “Coloque a sapatilha da segunda imagem na pessoa da primeira imagem.”

Referências de imagem

  • O Krea 3 utiliza cada referência na resolução com que foi carregada. Uma referência com mais de 4 MP é redimensionada para 4 MP.
  • Cerca de 1 MP é suficiente para a maioria das edições. Não aumente a resolução de uma referência antes de a enviar.
  • Quando os detalhes finos são importantes (texto pequeno, logótipos, tecidos, rostos num plano geral), envie a versão da imagem com a maior resolução que tiver.
  • Com cinco ou mais referências num pedido, cada referência é redimensionada para um máximo de 1536 px no lado maior. Para referências com todo o detalhe, envie quatro ou menos.

Zero Data Retention

O Krea 3 suporta Zero Data Retention para workspaces enterprise. Envie o cabeçalho X-Api-Zero-Data-Retention: 1. Com Zero Data Retention:
  • Todas as imagens em image_urls têm de ser data URIs em base64.
  • thinking_mode pode ser fast ou high.
  • Um pedido pode utilizar 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 das tarefas

Estados das tarefas, polling e resultados.

Webhooks

Receba uma notificação quando uma tarefa for concluída, em vez de fazer polling.