# Gerenciamento de Chave de API: Encontre, Regenerar e Atualizar Sua Chave

> Onde a Chave de API fica na sua página de Perfil, como gerar uma nova funciona para contas com senha e para contas vinculadas ao login do Google, e o que atualizar quando a regeneração faz a chave antiga parar de funcionar.

Uma **Chave de API** é uma credencial na sua conta ImageToTable.ai. Ela permite que uma ferramenta externa atue como sua conta: o [Complemento do Google Sheets](/docs/guides/google-sheets-add-on) pode se conectar com ela em vez de fazer login, e a [API v1](/docs/guides/api-access) a usa em cada chamada. Esta página cobre onde a chave fica, como substituí-la e o que atualizar depois.

## Onde encontrar sua Chave de API

A chave está na sua página de **Perfil**, em uma seção intitulada **Chave de API**. Para chegar lá, abra o menu da conta no canto superior direito do aplicativo — o que tem seu avatar e nome de usuário — e escolha **Perfil**.

Essa seção mostra tudo o que a chave precisa:

- A própria chave, oculta atrás de pontos por padrão. Use o botão de olho para revelá-la e o botão **Copiar** para copiá-la.
- Um botão que mostra **Regenerar chave de API** quando uma chave já existe, ou **Gerar chave de API** quando ainda não há nenhuma (a seção mostra *Nenhuma chave de API ainda* nesse caso).
- Uma breve nota de que a chave é para ferramentas externas, com um lembrete para mantê-la em segredo, além de um link para a documentação da API.

Trate a chave como uma senha. Ela pertence à conta, não a uma ferramenta específica, então o mesmo valor funciona em qualquer lugar onde uma chave seja aceita — e qualquer pessoa que a tenha pode atuar como sua conta. É por isso que a seção diz para mantê-la em segredo.

## Regenerando sua chave de API

Uma conta possui uma única chave de API. **Regenerar** substitui esse valor em vez de adicionar uma segunda chave, portanto nunca há mais de uma chave ativa. A etapa de confirmação depende de como sua conta faz login, porque uma conta criada com o login do Google não tem senha que você saberia digitar aqui.

### Se sua conta faz login com senha

Ao escolher **Regenerar chave de API**, um prompt de senha é aberto. Quando uma chave já existe, o prompt informa que a chave atual será invalidada antes de pedir sua senha; quando ainda não há chave, ele pede sua senha para criar uma. Digite a senha da sua conta e confirme para concluir.

Se a senha não corresponder, nada muda e a página informa que a senha estava incorreta.

### Se sua conta está vinculada ao login do Google

Para uma conta que faz login com o Google, a confirmação é uma etapa de login do Google em vez de senha. Ao escolher **Regenerar chave de API**, um diálogo intitulado **Confirme sua identidade** é aberto, pedindo que você confirme pelo Google. Se a conta já tiver uma chave, o diálogo informa que a chave atual será invalidada primeiro.

Este é o caminho a usar quando o prompt de senha acima não é uma opção para você, que é o caso de contas criadas pelo login do Google.

## Após regenerar: atualize os locais que usam a chave

Gerar uma nova chave tem efeito imediato. O valor anterior para de funcionar nesse momento — não há período de carência nem como manter as duas chaves ativas. Qualquer coisa que ainda envie a chave antiga é recusada até receber a nova.

| Onde a chave é usada | O que fazer após regenerar |
| --- | --- |
| Complemento do Google Sheets | Abra a seção Conta na barra lateral e cole a nova chave na caixa Colar chave de API . Se o complemento estiver conectado com Entrar com o Google em vez disso, ele não usa a chave e não precisa de alteração. |
| API v1 | Substitua a chave antiga pela nova em todos os lugares onde seu aplicativo a armazena. Chamadas feitas com a chave antiga não são mais autenticadas, então atualize a chave antes da próxima execução. |

Regenerar altera apenas a chave. Seus arquivos, [modelos](/docs/reference/glossary#template), [créditos](/docs/reference/glossary#credits) e plano permanecem intactos, e a nova chave tem o mesmo acesso que a antiga.

## Perguntas frequentes

### Perdi minha chave. Posso consultá-la novamente?

Sim, desde que você consiga entrar. A página Perfil sempre mostra a chave atual; ela fica oculta atrás de pontos até você revelá-la com o botão de olho, e você pode copiá-la de lá. Se preferir substituí-la em vez de reutilizá-la, use **Regenerar chave de API**.

### Posso ter mais de uma chave por vez?

Não. A conta possui uma única API Key. Regenerar substitui a chave, então o valor anterior para de funcionar assim que a nova é gerada.

### O Complemento do Google Sheets sempre precisa de uma chave?

Não. O complemento pode se conectar entrando com o Google ou colando uma API Key. Se você conectar com o login do Google, a barra lateral não usa a chave, e regenerar uma chave não afeta essa conexão. Apenas os locais que usam a chave precisam ser atualizados. Veja [Complemento do Google Sheets](/docs/guides/google-sheets-add-on).

### A API v1 usa esta chave?

Sim. Toda chamada da API v1 autentica com a chave, por isso a antiga precisa ser substituída após a regeneração. [Acesso à API](/docs/guides/api-access) explica para quem a API é destinada e o que ela exige; a referência completa está no [site de documentação para desenvolvedores](/developers/).

---

Source: https://imagetotable.ai/pt/docs/guides/api-key-management