zai-limits
Мониторинг квоты GLM Coding Plan (Z.AI) — Python-CLI, только стандартная библиотека. Показывает тариф, прогресс-бары по пулам (модельные токены + MCP-инструменты), время сброса и обратный отсчёт, предупреждение о пиковом окне.
🙏 Благодарность и происхождение
Контракт endpoint'ов мониторинга Z.AI и сама идея quota-монитора взяты из
community-плагина opencode-glm-quota
автора guyinwonder168 (лицензия MIT). Этот пакет — независимый Python-порт
под той же лицензией (MIT). Спасибо автору за разведку недокументированного
контракта Z.AI — без его работы этот порт был бы невозможен.
Оригинальный endpoint-контракт: src/api/endpoints.ts.
Установка
pip install zai-limits # из PyPI (после публикации)
pip install git+https://github.com/axisrow/zai-limits.git # из git
pip install . # из локального клона
Зависимостей нет — только стандартная библиотека Python ≥ 3.12.
Использование
zai-limits # квота (лимиты + сброс)
zai-limits --json # сырой JSON ответа
zai-limits --models # + расход токенов по моделям
zai-limits --key sk-... # свой ключ вместо auth.json
zai-limits --platform zhipu # платформа Zhipu (open.bigmodel.cn)
zai-limits --tz 8 # часовой пояс для времени сброса (по умолчанию — системный пояс пользователя)
=== Z.AI (api.z.ai) — квота Coding Plan ===
Тариф: MAX
▍ Модельные токены (главный пул — режет прогоны)
[███░░░░░░░░░░░░░░░░░] 15%
окно: 5-часовое окно
сброс: 2026-07-22 15:58 (через 0ч 27м)
▍ MCP-инструменты (web-search / web-reader / zread)
[██░░░░░░░░░░░░░░░░░░] 9%
...
Ключ API
Источники (по приоритету):
--key sk-...— явный аргумент./.env(или путь из--dotenv-path) —ZAI_API_KEY=.../ZHIPU_API_KEY=..., форматKEY=valueпострочно~/.local/share/opencode/auth.json→zai-coding-plan.key/zhipu-coding-plan.key- системный env, по платформе:
ZAI_API_KEY(для--platform zai),ZHIPU_API_KEY(для--platform zhipu)
./.env стоит выше auth.json и системного env — удобно, когда системная
переменная ZAI_API_KEY уже занята другим инструментом (например, отдельным
прокси/интеграцией) и обновляется независимо: положите актуальный ключ
zai-limits в ./.env, не трогая системный env.
Ключ выбирается строго по платформе — credential одной платформы никогда не
уходит на origin другой (см. resolve_api_key). Generic OAuth-провайдеры
(openai/glm, поле access) не используются как ключ Coding Plan.
Endpoint'ы
Недокументированы Z.AI публично; найдены реверс-инжинирингом (см. благодарность):
GET https://api.z.ai/api/monitor/usage/quota/limit ← лимиты / сброс / %
GET https://api.z.ai/api/monitor/usage/model-usage ← расход по моделям
GET https://api.z.ai/api/monitor/usage/tool-usage ← MCP-инструменты
CN-аналог: https://open.bigmodel.cn/api/monitor/usage/.... Auth — голый ключ
в Authorization (без префикса Bearer).
Безопасность
- Redirect-safety:
_NoAuthRedirectHandlerснимаетAuthorization/Cookieперед любым редиректом — ключ Coding Plan не утекает на кросс-хост/HTTP. - Platform-aware credentials: ключ и env выбираются строго по
--platform.
Лицензия
MIT — см. LICENSE. Содержит благодарность оригинальному автору
endpoint-контракта (guyinwonder168, opencode-glm-quota, MIT).
Metadata
Release files for zai-limits 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| zai_limits-0.1.3.tar.gz | 22.2 kB | Without provenance | Details for zai_limits-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| zai_limits-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for zai_limits-0.1.3-py3-none-any.whl |
Total release size: 35.1 kB
Release files / zai_limits-0.1.3.tar.gz
| Download URL | zai_limits-0.1.3.tar.gz |
|---|---|
| Size | 22.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e82b009c5093898bfa3104e469946eea8c459693c2a65cfbc69389c02c459e41
|
|
BLAKE2b-256 checksum How to use checksums |
a5dc10c76949c4106cf6fa05f7cb6cf7246934463d4e35182c7fd4b9d5eea10e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / zai_limits-0.1.3-py3-none-any.whl
| Download URL | zai_limits-0.1.3-py3-none-any.whl |
|---|---|
| Size | 12.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac060d7838d297a879930a40cf898a947142dfd314f080746befcc24eee156a2
|
|
BLAKE2b-256 checksum How to use checksums |
5adb3f2c84a9f55db57c85ebb1b0dec22f238357b6245bbe20c108f8eae1ef70
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Security for zai-limits 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.