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].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. Othinking_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
Comregional_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çalhoX-Api-Zero-Data-Retention: 1. Com o Zero Data Retention:
- Toda imagem em
image_urlsprecisa ser um data URI em base64. thinking_modepode serfastouhigh.- 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.