Aiberm Skill

A aiberm-skill ensina um agente de programação a ler a sua própria conta Aiberm. Depois de instalá-la, você pode perguntar ao Claude Code, ao Codex, ao Grok Bot ou a outro agente: “Quanto saldo ainda tenho na Aiberm?”. O agente chama a API da Aiberm e responde em linguagem simples.

A skill lê seu saldo, modelos, preços, tokens de API, registros de uso e recargas. Ela também pode criar, editar, ativar, desativar e excluir seus tokens de API, e pede sua confirmação antes de cada alteração.

Pré-requisitos

• Uma conta Aiberm (cadastre-se)
• Um agente compatível com skills, como o Claude Code, o Codex ou o Grok Bot
• git, curl e um shell compatível com bash. O macOS e o Linux normalmente já vêm com os três. No Windows, o Claude Code usa o Git Bash.

1. Obtenha seu ID de usuário e seu token de acesso do sistema

A skill precisa de dois valores, ambos em Configurações pessoais:

A Aiberm verifica os dois em todas as solicitações à conta, e o ID precisa pertencer à conta dona do token.

2. Instale a skill

Cole este prompt no Claude Code, no Codex, no Grok Bot ou em outro agente e deixe que ele instale a skill:

Instale a Aiberm Skill a partir de https://github.com/aiberm/aiberm-skill: copie a pasta skills/aiberm do repositório para a pasta de onde você carrega as skills.

Quando ele terminar, inicie uma nova sessão. Para atualizar a skill depois, envie o mesmo prompt de novo.

3. Defina as duas variáveis

O agente lê os valores do próprio ambiente, então defina-os antes de iniciá-lo.

macOS / Linux: adicione estas linhas ao ~/.zshrc ou ao ~/.bashrc e abra um novo terminal:

export AIBERM_ACCESS_TOKEN="seu-token-de-acesso-do-sistema"
export AIBERM_USER_ID="123"

Windows (PowerShell): execute os comandos abaixo e abra um novo terminal:

setx AIBERM_ACCESS_TOKEN "seu-token-de-acesso-do-sistema"
setx AIBERM_USER_ID "123"

Para verificar os valores antes de usar um agente, consulte o seu perfil. data.quota dividido por 500000 é o seu saldo restante em USD.

curl -sS "https://aiberm.com/api/user/self" \
  -H "Authorization: Bearer $AIBERM_ACCESS_TOKEN" \
  -H "New-Api-User: $AIBERM_USER_ID"

4. Pergunte ao seu agente

Inicie uma nova sessão do agente e pergunte com suas próprias palavras:

• “Quanto saldo ainda tenho na Aiberm?”
• “Quanto gastei ontem na Aiberm, separado por modelo?”
• “Liste meus tokens de API da Aiberm e quanto de cota resta em cada um.”
• “Quanto custa o claude-sonnet-5-5 por 1M de tokens na Aiberm?”
• “Quais modelos eu mais usei na Aiberm esta semana?”
• “Mostre minhas últimas recargas na Aiberm.”
• “Crie uma chave de API da Aiberm chamada my-app com limite de $5.”
• “Desative meu token old-test da Aiberm.”

Você também pode chamar a skill diretamente: /aiberm no Claude Code e no Grok Bot, $aiberm no Codex.

Os valores são convertidos para USD na proporção de 500000 de cota = $1. Os preços são os que a sua conta realmente paga.

Criar e alterar tokens de API

• Antes de criar, editar, ativar, desativar ou excluir um token, o agente mostra o que vai enviar e espera a sua confirmação.
• A menos que você peça outra coisa, um token novo recebe cota ilimitada e não expira, como no console. Você pode pedir um limite de gastos, uma data de expiração ou uma lista de modelos permitidos.
• Depois de criar um token, o agente mostra a chave completa dele uma única vez. Copie-a para o seu app ou para a sua configuração.
• A exclusão de um token não pode ser desfeita, e os apps que usam a chave dele param de funcionar imediatamente.

O que a skill não faz

• Com exceção dos tokens de API, ela não altera nada. Não faz pagamentos, não resgata códigos de recarga nem edita sua conta. Para isso, use o console.
• Ela não redefine seu token de acesso do sistema. A skill instrui o agente a nunca chamar essa rota.
• Ela não revela as chaves completas dos seus tokens de API existentes. A lista de tokens contém as chaves completas, e o agente as mostra mascaradas, como sk-abcd****wxyz. Copie uma chave completa em Gerenciamento de tokens. A única exceção é um token que o agente acabou de criar para você.

Solução de problemas

O código-fonte da skill e a lista completa de solicitações estão no repositório aiberm-skill. Para erros da própria API de modelos, consulte Tratamento de erros.