DESENVOLVEDORES

Como configurar a conexão OpenAI no Lúmina Orbe

Entenda como obter sua chave da OpenAI, onde configurá-la no Lúmina Orbe, como testar a conexão e como verificar se a integração está funcionando corretamente.

O que é a conexão OpenAI?

A integração com a OpenAI permite que o Lúmina Orbe utilize recursos de inteligência artificial para executar as funções que dependem da API da OpenAI.

Para estabelecer essa comunicação, o administrador precisa fornecer ao Lúmina Orbe uma chave de API válida criada na plataforma oficial da OpenAI.

A integração com a OpenAI é opcional.

O Lúmina Orbe não inclui uma conta, créditos ou cobrança da OpenAI. Quando recursos que dependem da API forem utilizados, o próprio cliente configura sua chave na plataforma da OpenAI e é responsável por eventuais custos cobrados pela OpenAI.

Chave da API Identifica e autoriza as solicitações feitas pelo Lúmina Orbe à API da OpenAI.
Lúmina Orbe Utiliza a chave configurada para estabelecer comunicação com os serviços da OpenAI.
Teste de conexão Permite verificar se a chave informada pode autenticar corretamente na API.
Segurança A chave deve permanecer protegida e não deve ser publicada em áreas públicas do site.

O que você precisa antes de começar?

Antes de configurar a conexão no Lúmina Orbe, tenha acesso à conta da OpenAI que será utilizada para administrar a API.

  • Uma conta na plataforma da OpenAI.
  • Acesso à área de gerenciamento das chaves de API.
  • Uma chave de API válida para utilização pelo Lúmina Orbe.
  • Acesso administrativo ao Lúmina Orbe.
A chave da API é uma informação confidencial.

Não publique sua chave em páginas, imagens, documentos públicos, repositórios ou código acessível diretamente pelo navegador.

Acesse a plataforma OpenAI

A chave utilizada pelo Lúmina Orbe deve ser criada e administrada na plataforma oficial da OpenAI.

Criar uma chave de API

Na área de chaves da plataforma OpenAI, crie uma nova chave que será utilizada pelo Lúmina Orbe.

1

Acesse as chaves

Abra a área de gerenciamento das chaves de API da plataforma OpenAI.

2

Crie uma chave

Utilize a opção disponibilizada pela plataforma para criar uma nova chave.

3

Copie a chave

Copie a chave imediatamente e mantenha-a armazenada de forma segura.

4

Volte ao Lúmina Orbe

Com a chave em mãos, retorne à Central de Conexões do Lúmina Orbe.

A chave deve ser copiada no momento em que estiver disponível.

O Lúmina Orbe não cria a chave da OpenAI. Ela é administrada diretamente na plataforma da OpenAI.

Preencher a chave no Lúmina Orbe

Depois de criar a chave na OpenAI, acesse a Central de Conexões do Lúmina Orbe e localize a seção correspondente à OpenAI.

1

Central de Conexões

Abra a área onde os serviços externos do Lúmina Orbe são gerenciados.

2

Localize OpenAI

Encontre o cartão OpenAI entre os serviços disponíveis.

3

Informe a chave

Cole a chave de API no campo destinado à configuração da OpenAI.

4

Salve

Utilize a opção para salvar a chave configurada no Lúmina Orbe.

Como testar a conexão?

Depois de salvar a chave, utilize a opção Testar conexão disponível na seção OpenAI da Central de Conexões.

Chave da API
→
Salvar chave
→
Testar conexão
→
OpenAI
→
Conexão confirmada
O teste verifica a autenticação da chave.

O Lúmina Orbe utiliza uma solicitação à API da OpenAI para verificar se a chave configurada pode estabelecer a comunicação.

Como saber se a conexão está funcionando?

Quando a configuração estiver correta e o teste for concluído com sucesso, a Central de Conexões apresentará o serviço OpenAI como conectado.

🟢 Conectado A conexão foi estabelecida e a chave está disponível para utilização.
🟡 Configurado Existe uma chave configurada, mas o estado de conexão ainda precisa ser confirmado.
🔴 Não configurado Nenhuma chave disponível foi encontrada para a conexão.
🔐 Origem da chave O Lúmina Orbe identifica a origem da chave atualmente utilizada pela conexão.

Origem da chave no Lúmina Orbe

O Lúmina Orbe pode utilizar a chave configurada diretamente pelo plugin ou, em determinadas instalações, uma chave existente anteriormente no wp-config.php.

Chave do Lúmina Orbe
→
OpenAI
A chave configurada pelo Lúmina Orbe possui prioridade.

Caso não exista uma chave armazenada pelo plugin, o sistema pode utilizar a chave disponível no wp-config.php como fallback.

Problemas comuns

Quando a conexão não for estabelecida, verifique primeiro os pontos abaixo.

  • A chave foi copiada corretamente.
  • Não existem espaços adicionais antes ou depois da chave.
  • A chave ainda é válida na plataforma OpenAI.
  • A chave foi configurada no campo correto da Central de Conexões.
  • A conexão foi testada depois que a chave foi salva.
  • A conta e a organização utilizadas na OpenAI possuem acesso aos recursos necessários.
Se a OpenAI recusar a conexão, verifique primeiro a própria chave na plataforma da OpenAI.

Uma chave inválida, incorreta ou sem autorização adequada pode impedir a autenticação do Lúmina Orbe.

Cuidados com a chave da OpenAI

A chave de API deve ser tratada como uma credencial privada de acesso aos serviços da OpenAI.

  • Não publique a chave em páginas públicas.
  • Não envie a chave em mensagens ou documentos destinados ao público.
  • Não coloque a chave diretamente em código JavaScript executado no navegador.
  • Se houver suspeita de exposição, revogue a chave na plataforma OpenAI e crie outra.

Em resumo

A conexão OpenAI do Lúmina Orbe utiliza uma chave de API criada e administrada na plataforma oficial da OpenAI.

A integração com a OpenAI é opcional. O Lúmina Orbe não inclui uma conta ou créditos da OpenAI. O administrador utiliza sua própria conta e chave de API, sendo responsável por eventuais custos cobrados pela OpenAI.

O administrador cria a chave, copia o valor com segurança, retorna à Central de Conexões do Lúmina Orbe, informa a chave e utiliza a opção de teste para verificar a comunicação.

Quando a autenticação é aceita, o Lúmina Orbe identifica a conexão como disponível para utilização pelos recursos que dependem da OpenAI.

OpenAI Chave de API Lúmina Orbe Salvar Testar conexão Conectado