Anual Pague anualmente e ganhe 2 meses grátis em qualquer plano pago. Ver planos
Entrar Comece grátis

Chaves de programador

Última atualização: 11 nov. 2026

Quem pode criar uma chave

Uma chave de programador pertence à sua conta ToRun. Para criar uma, a sua conta precisa de:

  • um endereço de e-mail confirmado,
  • um plano pago ou saldo comprado, porque a quota gratuita nunca paga chamadas à API.

Criar uma chave

  1. Abra a página Programadores da sua conta ToRun.
  2. Prima Criar chave e preencha o formulário:
    • Nome: algo que lhe diga onde a chave é utilizada, como «opencode no meu portátil».
    • Limite de gastos mensal (Runs): o máximo que esta chave pode gastar num mês.
    • Perguntar antes de uma geração acima de (Runs): uma geração que custaria mais do que isto pergunta-lhe primeiro.
    • Quando a quota do meu plano se esgotar, permitir que esta chave gaste da minha carteira: deixe esta opção desativada se a chave deve utilizar apenas a quota do seu plano.
  3. Passe a verificação de segurança e crie a chave.
  4. Copie a chave. Só é mostrada uma vez.

Mantenha a chave fora dos seus ficheiros

Guarde a chave numa variável de ambiente chamada TORUN_API_KEY e aponte a configuração da sua ferramenta para a variável em vez de colar lá a chave.

macOS e Linux, no perfil da sua shell (por exemplo ~/.zshrc ou ~/.bashrc):

export TORUN_API_KEY="trn_live_..."

Windows, no PowerShell (depois abra um novo terminal):

setx TORUN_API_KEY "trn_live_..."

Nunca faça commit de uma chave num repositório nem a coloque num ficheiro de configuração que partilhe.

Acompanhar e revogar

A página Programadores lista as suas chaves com quanto cada uma gastou este mês face ao seu limite, quando foi utilizada pela última vez e se está ativa. A última utilização é atualizada de poucos em poucos minutos, por isso uma chave que não reconhece em uso aparece lá.

Revogar para uma chave de imediato: uma ferramenta que a utilize é recusada na chamada seguinte. Se uma chave pode ter sido divulgada, revogue-a e crie uma nova.

Há um limite para o número de chaves ativas que uma conta pode ter e para o número de chaves que pode criar por dia.

A seguir

Ficou preso? O fórum costuma responder em poucas horas; o suporte, em 24 horas. Pergunte no fórum Contactar o suporte