AI Usage

Он отслеживает потребление, лимиты и затраты ваших учетных записей ИИ и записывает их в доступные только для чтения точки данных ioBroker. Адаптер только читает — он никогда не вызывает модель, ничего не меняет у провайдера и никогда не отправляет ваши данные никуда.

Что он может отслеживать

Три указанных адреса подписки используются собственными программами провайдеров. Они не задокументированы официально и могут измениться в любое время. Claude был протестирован на реальной подписке; ChatGPT и Google задокументированы в исходном коде, но никогда не запускались на реальных учетных записях — пожалуйста, сообщайте о любых проблемах, если что-то не так.

Требования

• Node.js >= 22
• ioBroker js controller >= 7.2.2
• В ioBroker Admin >= 8.0.11 адаптер считывает ключи API из центрального хранилища данных доступа администратора, вместо того чтобы повторно запрашивать их.

Меблировать

1. Установите адаптер и откройте настройки экземпляра.
2. На странице отображается список : сначала три подписки, затем по одной строке для каждого ключа ИИ, которые вы сохранили в разделе Администрирование → Настройки → Данные доступа .
3. Выберите, что вы хотите отслеживать. Для каждой строки установлен свой порог предупреждения (10–100%, по умолчанию 80%).
4. При оформлении подписки откроется область входа, которая проведет вас через весь процесс, требуемый этим провайдером. Сохраните изменения заранее — вход будет осуществлен через текущий экземпляр.
5. После успешной регистрации ваш аккаунт будет проверен немедленно; вам не нужно ждать следующего цикла.

Параметры

Запросы к учетным записям выполняются с интервалами, небольшими по времени. Если провайдер отвечает сообщением «слишком много запросов», для данной учетной записи начинается постепенно увеличивающаяся задержка (10 минут, удваивающаяся до одного часа) — при этом сохраняются самые последние считанные значения.

Дерево объектов

На одну учетную запись приходится один узел устройства с одинаковым именем для всех провайдеров:

ai-usage.0
├─ info.connection            mindestens ein Konto liefert Daten
├─ <konto>                    z. B. claude, chatgpt, gemini, <name>-api
│  ├─ info.unreach            das Offline-Kennzeichen; steuert das Symbol im Objektbaum
│  ├─ info.error              der Grund im Klartext; leer, solange alles läuft
│  ├─ info.lastUpdate         letzte erfolgreiche Abfrage
│  ├─ warning                 über der Warnschwelle des Kontos
│  ├─ limitReached            bei 100 %
│  ├─ limits.<fenster>.percent     Auslastung eines Limit-Fensters
│  ├─ limits.<fenster>.resetAt     wann es zurückgesetzt wird (leer, wenn keins läuft)
│  ├─ limits.<fenster>.active      ob dieses Fenster gerade das gültige Limit ist
│  ├─ credits.*               verbraucht / Grenze / Rest / Prozent, gewährt / aufgeladen,
│  │                          und ob das Guthaben noch für Aufrufe reicht
│  ├─ costs.*                 heute / Monat / gesamt / Monatsend-Prognose
│  ├─ tokens.*                Eingabe- und Ausgabe-Token heute
│  └─ models.<modell>.*       Token je Modell
└─ total
   ├─ costs.today / month / projectedMonth      summiert über alle USD-Konten
   ├─ maxLimitPercent         das vollste Konto (Limit-Fenster oder Budget)
   ├─ warningsActive          Konten über ihrer Schwelle
   ├─ limitReached            irgendein Konto bei 100 %
   ├─ accountsReachable       Konten, die gerade liefern
   └─ accounts                Konten, die du eingeschaltet hast

После создания точки данных сохраняются. Если поставщик временно пропускает поле, сама точка данных не исчезает — метки времени просто записываются как пустые. Удаляется только целое окно или модель, о которых поставщик больше не сообщает; а деактивированная учетная запись полностью теряет свой узел.

total.costsСуммируются только реальные деньги в одной и той же валюте — счетчики денежных средств (запросы на пополнение баланса, обнуление ваучеров) и иностранные валюты намеренно исключены.

Предупреждения — и то, что говорит в пользу этой версии.

Предупреждение для учетной записи срабатывает только в течение периода действия тарифного плана . Для каждой модели выделяется своя собственная точка данных, но никогда не появляется оповещение: модель, которую вы никогда не трогаете, может постоянно оставаться на 100%, а оповещение, которое никогда не срабатывает, хуже, чем его отсутствие. Исключением является Google — там нет периода действия тарифного плана, поэтому максимально заполненная модель отражает состояние учетной записи, а в уведомлении указывается название модели.

Выделенный бюджет конкурирует с окнами: счет, деньги на котором почти исчерпаны, так же неактивен, как и счет с постоянно работающим окном. Более высокое значение из двух определяет название предупреждения.

Статус онлайн

info.unreach Эта функция называется "данная учетная запись не выполняет доставку" и управляет символом подключения рядом с учетной записью в дереве объектов:

Защита данных и доступ к данным

• Токены подписки принадлежат исключительно адаптеру: они зашифрованы в папке данных экземпляра и доступны для чтения только владельцу. Адаптер никогда не читает и не записывает файлы ваших собственных программ.~/.codex/auth.json ,oauth_creds.json ) — чьи токены обновления меняются; два участника, обновляющие токены, отпишутся друг от друга.
• Ключи API берутся из центрального административного хранилища и не копируются.
• При входе в систему через Claude запрашиваются только права доступа к профилю — токен не может создавать ключи API или вызывать модели.
• Адаптер взаимодействует только с поставщиками ИИ и ни с кем другим.

Если что-то застряло

Кнопка входа в систему ничего не делает / строка бесконечно вращается. Сначала сохраните изменения и убедитесь, что экземпляр запущен — вход в систему представляет собой взаимодействие с запущенным адаптером.

После регистрации Google отображает страницу с ошибкой. Это сделано намеренно, и именно поэтому этот метод вообще работает. Скопируйте полный адрес из адресной строки и вставьте его в поле.

Сообщение "Не авторизован", хотя вы уже вошли в систему. Сохраненный логин был отклонен провайдером (токен обновления был отозван или истек срок его действия). Войдите снова — система предложит вам это сделать, вместо того чтобы показывать, что вы подключены.

Учетная запись OpenAI или Anthropic не предоставит никаких результатов. Для создания этих отчетов требуется ключ администратора организации . Личная учетная запись без организации вообще не сможет их создать — для этого используйте подписку Claude.

Клод отвечает: «Слишком много запросов». Увеличьте интервал. Адаптер регистрируется так же, как и собственные инструменты Клода, и ограничивает себя — однако при очень коротких интервалах между запросами в нескольких программах запросы всё равно могут накапливаться.

Поддерживать

Вопросы, сообщения об ошибках и предложения: https://github.com/krobipd/ioBroker.ai-usage/issues

Changelog

0.13.0 (2026-09-12)

• Fixed: The costs of an Anthropic organisation account were a hundred times too high — the provider counts them in cents, the adapter read them as dollars
• Fixed: The same error was in the adapter-wide cost totals
• Fixed: An account whose values could not be written to the object database kept reporting itself as delivering, with a last-update stamp that went on moving
• Fixed: An answer still waiting on the object database during shutdown could mark accounts online again afterwards, or delete objects
• Fixed: An answer in a shape the adapter does not recognise now counts as a service fault, instead of reading as "this account has nothing"
• Fixed: Limit windows and model channels are no longer deleted when a single answer says nothing about them
• Fixed: Token counters of an organisation account show 0 after UTC midnight instead of keeping yesterday's numbers
• Fixed: Restarting the instance above the warn threshold no longer raises the warning and the notification again
• Fixed: The "limit reached" total now counts a window the provider has closed, the way each account already did
• Fixed: A configured account row the adapter cannot use now says so in the log instead of disappearing
• Improved: The "active window" and DeepSeek "available" flags are written only when they actually change, so their timestamp stops moving on every poll
• Improved: The ChatGPT voucher inventory is fetched about once an hour instead of every poll, halving that account's requests
• Improved: The settings page shows a finished device-code sign-in right away instead of up to half a minute later
• Improved: The provider table now says that Anthropic's cost report leaves out Priority Tier spend, so an organisation on that tier really spends more than the figures show

0.12.1 (2026-09-07)

• Fixed: The last-update stamp of an account no longer moves forward while the provider is only throttling — it dates the values standing next to it, so you can see how old they really are
• Improved: Twenty-five more datapoints explain themselves in the object tree — what "today" means (the provider counts it in UTC), and why the cost totals can be lower than the accounts show

0.12.0 (2026-09-06)

• Fixed: An account that has not been signed in yet no longer reports a rejected sign-in — no warning, no notification, and the settings page keeps offering the sign-in button
• Fixed: An account whose API key is missing or unreadable is now shown as not delivering, instead of leaving its old values standing as though they were current
• Fixed: An answer arriving while the adapter shuts down can no longer mark an account as online again after the shutdown wrote it offline
• Fixed: A throttled account counts as delivering everywhere now — the connection icon and the "reachable accounts" total no longer contradict each other
• Fixed: A limit the provider reports as empty is no longer shown as 0 % used, and a Google quota without a value no longer reads as completely used up
• Fixed: A rejected ChatGPT sign-in now says so at once instead of leaving you waiting for a quarter of an hour, and a Google account keeps delivering when one route is unavailable
• Fixed: A Google account without an AI subscription says so, instead of asking for a sign-in that cannot change the answer
• New: Every limit window shows whether it is the limit currently in force — with Claude the provider states it, elsewhere it is the window that speaks for the account
• Improved: An account is reported as at its limit when the provider says the window is closed, not only when the percentage happens to reach 100
• Improved: A window's reset time is written to the minute, so a recording of it no longer gains an entry on every single query, only on real changes
• Improved: An account that is delivering again says so in the log, instead of leaving the warning about its outage standing as the last word on it
• Improved: The settings page no longer asks the adapter for every status every four seconds — the values now arrive on their own as they change
• Changed: "Balance sufficient for calls" now sits under credits, where it belongs; the datapoint at the old place is removed automatically
• Changed: Each account node shows the readable provider name instead of the internal one — "Claude Max (Claude)" instead of "Claude Max (claude-sub)"
• Fixed: A per-model folder is now named in your ioBroker language as well, instead of carrying the provider's bare model identifier as its only name
• New: The datapoints whose meaning is not obvious from their name now carry a short explanation in eleven languages, shown in the object tree

0.11.0 (2026-09-05)

• Fixed: Signing in from the instance settings works again — a leftover setting from an earlier version had silently closed the adapter's message channel, so none of the three flows reached it
• Fixed: A subscription whose stored sign-in was rejected no longer claims to be signed in — the row now offers the sign-in again instead of showing a green check next to an error
• Fixed: The status badge of an account no longer blanks out for a moment when a single status read is missed — a hiccup in the settings page is not an account without a status
• Fixed: A stored credential whose name sorts high in the alphabet is no longer missing from the account list in the instance settings
• Fixed: The settings page falls back to English for a browser language the adapter does not ship, instead of passing that language on unchecked
• Improved: All object names are now available in eleven languages instead of English only, and a renamed object reaches installations that already exist
• Improved: ChatGPT usage is read with the identity that endpoint expects, the way the Claude query already did — fewer rejected requests on that account
• Improved: Monthly cost reports can no longer be cut short in silence — a report that does not fit is reported in the log instead of producing a figure that is too low
• Changed: "Highest account utilisation" says what it always measured — the fullest limit window or the account's remaining budget

0.10.0 (2026-09-01)

• Fixed: The reset-time datapoint of a limit window no longer disappears and reappears — it stays and simply empties while no window is running
• Fixed: The settings page no longer shows the sign-in screen to a signed-in account, and its rows load without waiting for the credential storage scan
• Improved: Claude usage is read with far fewer rejections — the query now identifies itself the way the endpoint expects
• Changed: New Claude sign-ins request only the profile permission — the stored access can no longer create API keys or run models
• New: ChatGPT accounts show their purchasable limit-reset credits — how many are available and when the next one expires
• Improved: An unreadable provider answer is now reported as a service fault instead of a missing connection

License

MIT License

Copyright (c) 2026 krobi krobi@power-dreams.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Developed with assistance from Claude.ai