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].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. Othinking_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
Comregional_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çalhoX-Api-Zero-Data-Retention: 1. Com Zero Data Retention:
- Todas as imagens em
image_urlstêm de ser data URIs em base64. thinking_modepode serfastouhigh.- 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.