---
title: Chaves de API
description: Gere, copie, identifique e revogue uma chave de API pessoal do Runner com segurança.
---

As chaves de API são segredos pessoais para acesso programático ao Runner. Crie uma apenas para um aplicativo em que você confia, armazene-a com segurança e revogue-a quando não for mais necessária.

## O que este guia cobre

Você saberá como criar e salvar o segredo único, identificar chaves existentes sem expô-las e revogar uma chave com confirmação.

## Disponibilidade e pré-requisitos

- **Chaves de API** é condicional e aparece apenas quando ativada para sua conta.
- As chaves pertencem à sua conta pessoal, não a uma loja.
- Nunca coloque uma chave completa em chat, Memória do Agente, uma Habilidade, uma captura de tela, controle de versão ou documentação do produto.

## Caminho de entrada

Selecione **avatar → Configurações → Pessoal → Chaves de API**. Se a entrada estiver ausente, o recurso não está disponível para a conta atual.

## Controles

| Entrada ou botão | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Gerar Nova Chave** | Criar uma nova credencial. | Um diálogo abre com um campo Nome opcional. |
| **Nome** | Identifique o aplicativo mais tarde sem expor o segredo. | O nome aparece na tabela de chaves; em branco cria uma chave sem título. |
| **Criar Chave** | Gere a credencial. | O Runner abre **Chave de API Gerada** e exibe o segredo completo uma vez. |
| Ícone de olho | Verifique o valor recém-gerado completo antes de armazená-lo. | O valor único é mostrado ou mascarado no diálogo de sucesso. |
| Ícone de cópia | Copie a nova chave com precisão. | O Runner a copia para a área de transferência e mostra confirmação. |
| **Salvei** | Feche a visualização de segredo único. | O valor completo é limpo do diálogo e não pode ser mostrado novamente lá. |
| Tabela de chave existente | Identifique chaves com segurança. | O Runner mostra Nome, Prefixo, Criado e Último Uso, não o segredo completo. |
| Ícone de exclusão | Revogue uma chave existente. | Uma confirmação explica que a revogação não pode ser desfeita. |
| **Revogar** | Desative a chave selecionada. | Após o sucesso, a chave é removida da lista e não pode mais autenticar. |

## Gerar e armazenar uma chave

1. Abra **Pessoal → Chaves de API**.
2. Selecione **Gerar Nova Chave**.
3. Digite um Nome descritivo, como o aplicativo ou ambiente. Não coloque um segredo no nome.
4. Selecione **Criar Chave**.
5. Em **Chave de API Gerada**, revele a chave apenas se necessário e selecione Copiar.
6. Armazene-a em um gerenciador de segredos confiável.
7. Confirme o valor armazenado antes de selecionar **Salvei**.
8. Use o Prefixo da tabela para identificar a chave mais tarde sem expor o valor completo.

O Runner avisa que a chave completa não será mostrada novamente. Se você fechar o diálogo sem salvá-lo, revogue essa chave e crie uma substituição em vez de tentar recuperar o segredo.

## Revogar uma chave

1. Corresponda a chave pretendida por Nome e Prefixo.
2. Selecione seu ícone de exclusão.
3. Revise a confirmação **Revogar**.
4. Selecione **Revogar** apenas quando o aplicativo dependente estiver pronto para parar de usá-lo.
5. Confirme **Chave de API revogada** e remova o segredo antigo do aplicativo.

A revogação é destrutiva e não pode ser desfeita. Crie uma nova chave se o acesso for necessário novamente.

## Estados e limites

- **Nenhuma chave de API ainda** é o estado vazio normal.
- O valor completo de uma nova chave aparece apenas em seu diálogo de sucesso.
- As linhas existentes mostram um prefixo e datas de uso, não uma chave recuperável.
- **Nunca** em Último Uso significa que o Runner não registrou uma solicitação para essa chave.
- Os botões Criar e Revogar mostram progresso e não devem ser enviados repetidamente.

## Solução de problemas

- Se Chaves de API estiver faltando, não use um link direto copiado; o recurso está desativado para esta conta.
- Se a cópia da área de transferência falhar, revele o novo valor e copie-o manualmente para um gerenciador de segredos seguro, depois oculte-o novamente.
- Se você perdeu uma chave completa, revogue sua linha e gere uma substituição.
- Se um aplicativo parar de funcionar após a revogação, atualize-o com uma chave recém-criada; a chave antiga não pode ser restaurada.
- Se a chave errada foi selecionada, Cancele a confirmação e compare Nome e Prefixo novamente.

## Guias relacionados

- [Segurança e sessões](./security-and-sessions)
- [Configurações pessoais e espaços de trabalho](./personal-settings-and-workspaces)
- [Segurança de memória](../agent/memory)