Chaves de API: autenticação para a API REST, a CLI, os SDKs e o MCP

As chaves de API autenticam o acesso programático aos dados do LLM Pulse. Utilize-as com a API REST, a CLI nativa em Rust, os SDKs oficiais, a integração MCP e o conector do Looker Studio. Disponíveis no plano Scale ou num plano superior.

A página Chaves de API lista todas as chaves que criou, mostra o respetivo prefixo e a data da última utilização e permite gerar novas chaves ou revogar as antigas.

O que faz

• Criar chaves de API com nomes personalizados para diferentes utilizações
• Mostra o prefixo e a data de última utilização da chave para identificação
• As chaves começam com o prefixo llmpulse_
• Permite revogar chaves que já não são necessárias

Como utilizar

1. Clique no seu nome ou avatar no canto inferior esquerdo da barra lateral
2. Clique em Chaves de API
3. Clique em Nova chave de API e atribua-lhe um nome descritivo
4. Copie a chave completa de imediato, uma vez que só é apresentada uma vez
5. Utilize a chave como token Bearer: Authorization: Bearer llmpulse_your_key_here
6. Revogue as chaves de que já não precisa na mesma página

Limitar uma chave a alguns projetos

Ao criar uma chave, o campo Projetos define aquilo a que esta pode aceder. Deixe-o vazio (Todos os projetos) para obter uma chave com acesso a toda a conta, incluindo os projetos que adicionar mais tarde, tal como acontece com todas as chaves criadas antes de esta opção existir. Escolha um ou mais projetos para limitar a chave a esses projetos, por exemplo, quando uma agência ou um portal de clientes entrega a um cliente uma chave para os projetos desse cliente.

Uma chave limitada a alguns projetos:

• Lista apenas esses projetos e trata qualquer outro projeto como se não existisse (ERR_PROJECT_NOT_FOUND)
• Só acede aos prompts, respostas, concorrentes, etiquetas, webhooks, relatórios e estudos desses projetos
• Não pode criar projetos nem utilizar os endpoints de equipa: esses pedidos são recusados com ERR_KEY_PROJECT_SCOPED (403)

Não é possível alterar os projetos depois de a chave ser criada. Para dar a um cliente acesso a outro conjunto de projetos, crie uma nova chave e revogue a antiga. Eliminar um projeto remove-o das chaves limitadas a esse projeto, e uma chave que fique sem nenhum projeto é revogada.

Após uma alteração do plano

As chaves de API só funcionam enquanto a conta estiver no plano Scale ou num plano superior. Se a conta passar para um plano inferior, as chaves continuam na lista e podem ser revogadas, mas todos os pedidos feitos com essas chaves são recusados com ERR_PLAN_REQUIRED (403). Voltam a funcionar assim que a conta regressar ao plano Scale ou a um plano superior. As ligações MCP autenticadas através de OAuth não são afetadas, porque não utilizam uma chave de API.

Dicas e notas

• Disponíveis no plano Scale ou num plano superior
• Limite de pedidos da API: 300 pedidos por minuto por chave
• Mantenha as chaves de API em segredo e nunca as exponha em código do lado do cliente nem em repositórios públicos
• A mesma chave funciona com a API REST, a CLI nativa em Rust, os SDKs oficiais, o MCP sem interface gráfica e o conector do Looker Studio
• Cada chave tem um prefixo apresentado na lista para identificação sem revelar a chave completa