Aiberm Skill

aiberm-skill учит агента для программирования читать данные вашего собственного аккаунта Aiberm. После установки можно спросить Claude Code, Codex, Grok Bot или другого агента: «Сколько у меня осталось на балансе Aiberm?» Агент сам обратится к API Aiberm и ответит простыми словами.

Skill показывает баланс, модели, цены, API-токены, журналы использования и историю пополнений. Ещё он умеет создавать, изменять, включать, отключать и удалять ваши API-токены и перед каждым изменением спрашивает вашего подтверждения.

Info

Skill — это папка с файлом SKILL.md. Когда ваш вопрос подходит под описание Skill, агент читает этот файл и сам запускает curl. Ничего не работает в фоне, ничего не нужно собирать или держать запущенным.

Предварительные требования

  • Аккаунт Aiberm (зарегистрироваться)
  • Агент с поддержкой Skills, например Claude Code, Codex или Grok Bot
  • git, curl и bash-совместимая оболочка. В macOS и Linux обычно есть все три. В Windows Claude Code использует Git Bash.

1. Получите ID пользователя и токен доступа к системе

Для Skill нужны два значения. Оба находятся на странице Личные настройки:

ЗначениеГде найти
ID пользователяВ шапке вверху страницы, в виде ID: 123
Токен доступа к системеВкладка Настройки безопасности → Токен доступа к системе → Сгенерировать токен

Aiberm проверяет оба значения при каждом запросе к аккаунту. ID должен принадлежать тому же аккаунту, что и токен.

Warning

Токен доступа к системе — не API-ключ (sk-...). Он работает как вход в консоль: любой, у кого он есть, может делать в консоли всё то же, что и вы. Храните его в секрете. Кнопка Сгенерировать заново заменяет токен, и всё, что ещё использует старый, перестаёт работать.

2. Установите Skill

Вставьте этот промпт в Claude Code, Codex, Grok Bot или другой агент, и он сам установит Skill:

Установи Aiberm Skill из https://github.com/aiberm/aiberm-skill: скопируй папку skills/aiberm из репозитория в папку, из которой ты загружаешь Skills.

Когда агент закончит, начните новый сеанс. Чтобы потом обновить Skill, отправьте тот же промпт ещё раз.

3. Задайте две переменные

Агент берёт значения из переменных окружения, поэтому задайте их до запуска агента.

macOS / Linux: добавьте эти строки в ~/.zshrc или ~/.bashrc, затем откройте новый терминал:

export AIBERM_ACCESS_TOKEN="ваш-токен-доступа-к-системе"
export AIBERM_USER_ID="123"

Windows (PowerShell): выполните команды ниже, затем откройте новый терминал:

setx AIBERM_ACCESS_TOKEN "ваш-токен-доступа-к-системе"
setx AIBERM_USER_ID "123"
Tip

Только для Claude Code: вместо этого обе переменные можно указать в блоке env файла ~/.claude/settings.json.

Чтобы проверить значения ещё до подключения агента, запросите свой профиль. data.quota, делённое на 500000, — это остаток баланса в долларах США.

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

4. Спросите агента

Начните новый сеанс агента и спросите своими словами:

  • «Сколько у меня осталось на балансе Aiberm?»
  • «Сколько я вчера потратил в Aiberm? Разбей по моделям.»
  • «Покажи мои API-токены Aiberm и сколько квоты осталось у каждого.»
  • «Сколько стоит claude-sonnet-5-5 за 1M токенов в Aiberm?»
  • «Какими моделями в Aiberm я больше всего пользовался на этой неделе?»
  • «Покажи мои последние пополнения в Aiberm.»
  • «Создай API-ключ Aiberm с именем my-app и лимитом $5.»
  • «Отключи мой токен Aiberm old-test.»

Skill можно также вызвать напрямую: /aiberm в Claude Code и Grok Bot, $aiberm в Codex.

О чём вы спрашиваетеЧто читает Skill
Баланс и общие расходыGET /api/user/self
Модели, которые вам доступныGET /api/user/models
Цены моделейGET /api/pricing
API-токеныGET /api/token/
Журналы использованияGET /api/log/self
Сводка по использованиюGET /api/log/self/stat
Использование по часам и моделямGET /api/data/self
История пополненийGET /api/user/topup/self
Создание, изменение или удаление API-токеновPOST, PUT или DELETE /api/token/

Суммы пересчитываются в доллары США по курсу 500000 квоты = $1. Цены — это то, что ваш аккаунт платит на самом деле.

Создание и изменение API-токенов

  • Перед каждым созданием, изменением, включением, отключением или удалением агент сообщает, что именно отправит, и ждёт вашего подтверждения.
  • Если не попросить иначе, новый токен создаётся с неограниченной квотой и без срока действия, как в консоли. Можно попросить лимит расходов, срок действия или список разрешённых моделей.
  • После создания токена агент один раз показывает его полный ключ. Скопируйте его в своё приложение или конфигурацию.
  • Удаление токена нельзя отменить, а приложения, которые используют его ключ, сразу перестают работать.

Чего Skill не делает

  • Помимо API-токенов, он ничего не меняет. Не проводит платежи, не активирует коды пополнения и не редактирует аккаунт. Для этого используйте консоль.
  • Он не сбрасывает токен доступа к системе. Skill запрещает агенту обращаться к этому маршруту.
  • Он не раскрывает полные ключи ваших существующих API-токенов. Список токенов содержит полные ключи, но агент показывает их в замаскированном виде, например sk-abcd****wxyz. Полный ключ можно скопировать в разделе Управление токенами. Единственное исключение — токен, который агент только что создал для вас.
Warning

Эти правила — инструкции для агента, а не техническая блокировка. Токен даёт всё, что даёт ваш вход в консоль. Используйте его только с агентами и на компьютерах, которым доверяете. Если токен утёк, нажмите Сгенерировать заново на странице «Личные настройки».

Устранение неполадок

Что вы видитеЧто делать
Агент сообщает, что переменные не заданыЗадайте обе, откройте новый терминал и начните новый сеанс агента.
未提供 New-Api-UserНе задана переменная AIBERM_USER_ID.
New-Api-User 与登录用户不匹配AIBERM_USER_ID не совпадает с ID аккаунта, которому принадлежит токен. Скопируйте ID на странице «Личные настройки» того же аккаунта.
access token 无效Токен неверный или был сгенерирован заново. Сгенерируйте новый и обновите AIBERM_ACCESS_TOKEN.
Агент не использует SkillПроверьте, что файл лежит по пути ~/.claude/skills/aiberm/SKILL.md или ~/.agents/skills/aiberm/SKILL.md, затем начните новый сеанс. Или вызовите Skill напрямую: /aiberm (Claude Code, Grok Bot) или $aiberm (Codex).
时间跨度不能超过 1 个月Почасовая статистика охватывает не больше 30 дней за один запрос. Запросите период покороче.

Исходный код Skill и полный список запросов — в репозитории aiberm-skill. Ошибки самого API моделей описаны в разделе Обработка ошибок.