Integração de IA com sua própria chave (BYOK)

OpenAI oferece geração de imagens, fundo transparente e a função Melhorar detalhes com IA. Google Gemini gera ilustrações a partir de prompts; a integração atual não oferece fundo transparente nem melhoria de detalhes com IA para Gemini. Você pode remover o fundo de uma imagem do Gemini depois, usando as ferramentas do Designer.

Anthropic Claude serve para tarefas de texto. No Designer local do WordPress, ele pode preparar um conjunto com texto, vetores simples e código QR quando a camada Imagem está desativada. Ele não substitui um modelo que gera ilustrações rasterizadas.

O catálogo abaixo apresenta os modelos compatíveis com a integração atual. No plugin WordPress, você escolhe os modelos de texto e de imagem em Detalhes da conexão. No aplicativo Alter Product, você escolhe uma conexão e a configuração do serviço atribui o modelo - a janela do gerador não tem um seletor de modelos separado.

A configuração padrão do OpenAI usa gpt-5.4-mini para texto e gpt-image-2.5-sunburst para imagem. No Gemini, são gemini-3.5-flash-lite e gemini-3.1-flash-image. A possibilidade de usar um modelo específico também depende da disponibilidade dele e das permissões da sua conta de API.

Abra Configurações de IA, escolha o provedor e a finalidade Geração de imagens e adicione sua chave de API. Um nome opcional ajuda a diferenciar as conexões, como uma conta empresarial e outra para testar ideias. Aceite a informação sobre custos e selecione Adicionar chave.

Quando há várias conexões ativas, o gerador permite selecioná-las pelo nome. Nas configurações, você também pode definir uma conexão padrão, mudar o nome ou a chave, desativar ou excluir uma conexão. Para criar um conjunto de camadas com imagem, não é necessário adicionar uma chave separada para prompts.

Salvar uma conexão não inicia a geração. A chave é armazenada no servidor de forma criptografada; a interface mostra apenas os caracteres finais. Excluir uma conexão do Alter Product não revoga a chave na conta do provedor.

Descreva o que a imagem deve representar, como os elementos devem ser distribuídos e quais cores devem predominar. Para uma estampa, vale especificar se o motivo deve aparecer por inteiro, o espaço livre ao redor e a presença ou ausência de textos. O campo do prompt aceita até 500 caracteres.

Você pode começar com um exemplo abaixo do campo do prompt e adaptá-lo ao seu produto. Se quiser um texto específico, coloque o conteúdo entre aspas e ative a camada Texto. Escolha um estilo compatível com a descrição - a configuração de estilo tem prioridade sobre uma instrução contraditória no prompt.

Expanda Camadas e marque apenas os elementos necessários. Imagem e Texto estão ativos inicialmente. Para uma única ilustração, deixe apenas Imagem. Adicione os outros tipos de camadas quando quiser uma composição para continuar ajustando.

Textos na imagem e a camada Texto produzem resultados diferentes. A primeira opção permite letras dentro do bitmap. A segunda cria textos separados que podem ser alterados depois com as ferramentas de texto. Para um slogan que você pretende editar, escolha a camada Texto.

Após ativar Código QR, informe o conteúdo ou a URL no campo específico. Descrever a aparência do código no prompt não substitui essa informação. Depois de inserir, confira o conteúdo e a leitura do código no projeto final.

Escolha o formato Quadrado, Vertical ou Horizontal, respectivamente 1:1, 2:3 ou 3:2. Adapte-o à forma da estampa: um motivo vertical para a frente de uma camiseta, uma composição horizontal para um produto largo ou um quadrado para uma imagem versátil.

Você pode escolher entre 31 estilos prontos e o estilo Personalizado, no qual insere sua própria descrição com até 500 caracteres. Crie uma identidade consistente para a coleção usando o mesmo estilo e uma paleta semelhante nos próximos prompts.

O fundo pode seguir o prompt, ter uma cor escolhida ou ser transparente. Selecione a transparência nas configurações quando precisar apenas do motivo para a estampa. Na integração atual, essa opção exige OpenAI; para Gemini, escolha o fundo do prompt ou uma cor. Sempre examine o resultado antes de usá-lo.

Use as descrições abaixo como ponto de partida. Defina o estilo, o fundo e as camadas no formulário e concentre o prompt no motivo e na composição. Esses exemplos não garantem um resultado idêntico em cada geração.

Clique em uma miniatura para abrir uma prévia maior. No menu do resultado, você encontrará Copiar prompt e Gerar novamente. Ao copiar, é possível voltar à descrição e alterar, por exemplo, a paleta, o tema ou o texto antes de gerar de novo.

Gerar novamente prepara um novo resultado com as configurações salvas. A operação usa a conexão original e a chave atual, então a conexão precisa continuar disponível. É outra solicitação ao provedor, que pode gerar uma cobrança, e não o download de uma cópia da imagem anterior.

Se o resultado estiver parcial, confira as mensagens e as camadas presentes. Você pode aproveitar os elementos disponíveis, mas verifique os textos, o QR, o fundo e a composição completa antes de salvar. O histórico permite visualizar e inserir conjuntos salvos mesmo depois de desativar a chave.

Ampliar imagem prepara uma versão maior do bitmap sem uma nova chamada ao provedor de IA. Na implementação atual, o lado maior é duplicado até o máximo de 4096 px. A função se aplica a resultados que contêm uma imagem.

Uma prévia mais leve pode ser mantida para trabalhar na cena, enquanto o arquivo maior é usado na impressão. O texto separado, os vetores e a disposição das camadas permanecem iguais. Se o resultado já estiver no projeto, o arquivo de impressão maior poderá ser vinculado a ele.

Mais pixels não garantem a recuperação dos detalhes finos do original nem uma impressão adequada em qualquer tamanho. Confira a imagem nas dimensões finais da estampa e escolha os parâmetros de exportação no Gerenciador de impressão.

Para um resultado compatível do OpenAI, escolha Melhorar detalhes com IA. Preencha a Descrição das alterações, por exemplo “defina melhor os contornos do pelo, preserve a composição e as cores”, e inicie a melhoria. O campo aceita até 2000 caracteres. A imagem e a instrução são enviadas ao provedor de IA.

A operação exige a conexão original ativa, um modelo disponível e um resultado com uma única imagem. No aplicativo, cada nova melhoria parte da última revisão concluída. Na versão atual do plugin WordPress, a melhoria pelo cartão do histórico usa a imagem original. As camadas separadas de texto e vetores não fazem parte do bitmap alterado.

A melhoria com IA pode mudar a aparência e gerar outra cobrança. Examine o novo resultado e selecione-o para o projeto. A alteração visual não substitui automaticamente a imagem já colocada na cena.

Use Selecionar no cartão do resultado. A janela do gerador será fechada e você poderá indicar uma posição na área de impressão. Também é possível arrastar a miniatura ou a prévia para a cena. Você precisa de um projeto aberto e de uma área de impressão preparada.

O conjunto é adicionado ao projeto como um grupo de camadas. Você mantém a possibilidade de editar texto, vetores simples e código QR; a ilustração gerada continua sendo uma imagem. Ajuste a posição e a escala em 2D e confira a disposição da estampa no modelo 3D.

Depois de adicionar a imagem, você pode usar as ferramentas existentes: remoção de fundo, máscaras, filtros, meios-tons, vetorização e repetição de padrões. Essa etapa de edição no Designer está disponível independentemente da geração em si.

Depois dos ajustes, salve o projeto com o botão padrão do Designer. Para reutilizar a composição, escolha Salvar como novo template (biblioteca) na janela de salvamento correspondente. Use o histórico de geração para selecionar resultados e a biblioteca para guardar recursos reutilizáveis.

No WordPress, use o projeto ou template salvo nos produtos locais da loja. O cliente pode personalizar a composição compartilhada no Customizer com os elementos preparados anteriormente. Gerar uma imagem não a publica automaticamente na biblioteca nem na oferta da loja.

Acesse Alter Product → Configurações → Integração de IA e selecione Adicionar provedor. Escolha OpenAI, Google Gemini ou Anthropic Claude. Em Detalhes da conexão, selecione os modelos que deseja usar.

Uma conexão direta armazena uma chave separada no plugin, criptografada com as chaves da instalação do WordPress. Como alternativa, você pode usar WordPress AI Client e um conector compartilhado configurado em Configurações → Connectors. Essa opção exige WordPress 7.0 ou superior e um conector disponível para o provedor.

Salve a conexão, defina os limites, marque Ativar IA usando minhas contas de provedores e clique em Salvar configurações de IA. Na janela aberta, leia as informações sobre custos, processamento de conteúdo e verificação dos resultados, marque sua aceitação e confirme o salvamento. Adicionar uma conexão, por si só, não ativa a geração.

Para OpenAI e Gemini, a conexão de imagens também inclui um modelo de texto usado na preparação da composição. Escolha os dois modelos nos detalhes. Claude permite trabalhar com texto; para usá-lo no gerador local, desative Imagem e selecione as camadas de texto, vetores simples ou QR necessárias.

No plugin, a qualidade das imagens OpenAI é limitada a Low por padrão e pode ser alterada nos limites de uso. A integração Gemini usa resolução 1K; esse limite de qualidade do OpenAI não se aplica a ela. As configurações e a preparação da composição são diferentes do serviço no aplicativo, então o mesmo prompt não significa um resultado idêntico nos dois ambientes.

Abra um projeto de produto local pelo Product Designer no plugin ou pela ação do Designer no produto WooCommerce. Inicie o Gerador de IA, prepare um resultado e adicione-o ao projeto seguindo o processo descrito anteriormente.

A geração exige um administrador com permissão para gerenciar as configurações do WordPress. As interfaces públicas Customizer, Configurator e Viewer não executam geração de IA com a chave da loja. Elas podem apresentar e usar imagens salvas anteriormente nos produtos preparados.

Ao salvar um projeto ou template, as imagens necessárias são copiadas para os recursos locais do WordPress. Excluir uma entrada do histórico de IA não remove arquivos independentes já salvos no projeto. Você continua gerenciando os templates em Assets; não se trata de um gerador de IA separado na aba de recursos.

A geração, a nova geração e a melhoria de detalhes com IA usam a API do provedor. Uma ação na interface pode envolver mais de uma solicitação, como preparar a composição e gerar a imagem. Visualizar, inserir um resultado salvo e ampliar pelo método padrão não iniciam uma nova geração no provedor.

No plugin, o limite diário padrão é de 20 tentativas de solicitação, compartilhadas entre os administradores do site. Em um conjunto comum com imagem, o planejamento e a imagem geralmente consomem duas tentativas; apenas texto consome uma. Tentativas malsucedidas também podem ser contabilizadas. O contador é reiniciado à meia-noite UTC.

O limite de tentativas não é um orçamento financeiro. Defina também os limites de gastos disponíveis na conta do provedor e confira a cobrança. Cancelar uma tarefa não reverte o custo de uma chamada já realizada. No aplicativo, aplicam-se os limites do serviço e do provedor; eles não usam o mesmo contador que o limite do seu plugin.

Guarde os materiais prontos em projetos ou templates, em vez de depender apenas do histórico de IA. Antes de enviar para produção, confira os textos, a nitidez, a transparência, o tamanho e a leitura do código QR. Depois, prossiga para as áreas de impressão e o Gerenciador de impressão.

No plugin, a conexão direta e o conector compartilhado do WordPress têm configurações de chaves separadas. Mudar o método de conexão não transfere automaticamente o segredo entre eles. As chaves diretas e o histórico privado de IA estão vinculados às chaves de criptografia da instalação, então preserve essas chaves junto com um backup seguro do banco de dados e dos arquivos do WordPress.