# Chaves de API

Crie uma chave para que seu próprio agente de IA ou script possa usar a SimianX AI, copie-a uma vez, limite quanto ela pode gastar e revogue-a.

- Todos os planos. O número de chaves depende do seu plano.
- Criar uma chave é grátis. Tudo o que uma chave roda usa os pontos da sua conta.

Uma chave de API permite que um agente de IA ou um script use a SimianX AI na sua conta sem a sua senha. Esta página trata das chaves em si.

## Criar uma chave

1. Abra o menu da conta, selecione **Minha Conta** e abra a aba **Chaves de API**.
2. Selecione **Criar chave**. O formulário **Nova chave de API** é aberto.
3. No campo **Nome**, digite um nome que indique onde a chave é usada.
4. Em **O que esta chave pode fazer**, escolha o que a chave pode fazer: ler dados de mercado e notícias, rodar análises, gerenciar pilotos automáticos, gerenciar chaves. As três primeiras opções vêm selecionadas por padrão. Sem a permissão de rodar análises, uma chave pode ler dados, mas não pode iniciar uma análise.
5. Opcional: defina **Orçamento diário (pontos)**, **Orçamento mensal (pontos)** ou **Maior chamada única (pontos)**. Um campo vazio significa sem limite.
6. Opcional: preencha **Agente**, **Lista de IPs permitidos** (um endereço por linha) e **Expira**.
7. Selecione **Criar chave**.

![O formulário Nova chave de API com o campo Nome, as opções de permissão, três campos opcionais de orçamento em pontos, o campo Agente, a caixa Lista de IPs permitidos, a lista Expira e o botão Criar chave.](https://fw.simianx.ai/help/pt/account-api-key-form.light.5617853f6a.webp)

*O formulário Nova chave de API*

## Copiar a chave

A janela **Sua nova chave** mostra a chave completa. Selecione **Copiar** e guarde a chave no seu agente ou em um gerenciador de senhas, depois selecione **Concluído**.

> **Não pode ser desfeito**
> A chave completa só é mostrada esta única vez. A SimianX AI guarda apenas um hash e não consegue mostrá-la de novo. Se você perder a chave, revogue-a e crie uma nova.

![A janela Sua nova chave. Ela tem quatro linhas, cada uma com um botão Copiar: a chave completa, a linha para defini-la como variável de ambiente de um agente, uma frase que manda o agente se configurar sozinho e um comando para testar a chave. O botão Concluído fica embaixo.](https://fw.simianx.ai/help/pt/account-api-key-token.light.2a0015c122.webp)

*A chave é mostrada uma vez*

## Ler a lista

Cada chave mostra o nome, os primeiros caracteres, os pontos gastos hoje e neste mês, o orçamento e quando foi usada pela última vez.

- **Uso**: requisições e pontos dos últimos 7 dias, por endpoint.
- **Editar**: altere o nome, as permissões, os orçamentos, o agente e a lista de IPs permitidos. As alterações valem a partir da próxima requisição.
- **Revogar**: interrompa a chave.

## Revogar uma chave

1. Selecione **Revogar** na linha da chave.
2. Na caixa de diálogo **Revogar esta chave?**, selecione **Revogar**.

> **Não pode ser desfeito**
> As requisições com uma chave revogada param de funcionar na hora, e a chave não pode ser restaurada. Os pilotos automáticos que a chave iniciou continuam rodando na sua conta. Pare-os na página **Pilotos automáticos** se quiser.

## Pontos

> **Usa pontos**
> Uma chave gasta os pontos da sua conta, com as mesmas tarifas do site. Defina um orçamento em cada chave para que um agente não possa gastar mais do que você permite. Veja [Pontos e tarifas](https://www.simianx.ai/pt/points).

## Bom saber

- A aba mostra quantas chaves você tem e quantas o seu plano permite. No limite, o botão **Criar chave** fica desativado: revogue uma chave ou [mude de plano](https://www.simianx.ai/pt/help/points-and-plans/change-plan.md).
- Um agente também pode pedir uma chave sozinho: ele passa um link a você, e você aprova ou recusa. Veja [Conectar seu próprio agente de IA](https://www.simianx.ai/pt/help/market-tools/connect-ai-agent.md).
- Uma chave não pode entrar no site e não pode alterar sua assinatura nem seus dados de pagamento.

---

Página da web: https://www.simianx.ai/pt/help/account/api-keys
Capítulo: [Conta](https://www.simianx.ai/pt/help/account.md)
Manual completo: https://www.simianx.ai/pt/help/manual.md