Сайт и CLI neurobrix используют один и тот же публичный API. Для всего описанного ниже вход в систему и токен не нужны.
https://neurobrix.org/api
Программным клиентам следует отправлять обычный заголовок
User-Agent. Периферийный узел перед хабом отвечает 403 некоторым агентам библиотек по умолчанию.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Параметр | Описание |
|---|---|
category |
Одна из десяти категорий: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Текстовый поиск |
page |
Номер страницы, начиная с 1 |
limit |
Результатов на странице: от 1 до 100, по умолчанию 12 (значения выше 100 урезаются до 100). CLI запрашивает 100 |
visibility |
all выводит также изъятые (скрытые) модели |
Ответ:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize — строка (значение может превышать 32 бита). visibility — PUBLIC или DEPRECATED (по-прежнему доступна для скачивания; visibilityReason объясняет причину). Скрытые модели отсутствуют, если не указано visibility=all.
Неизвестная категория возвращает 400 со списком допустимых:
{ "error": "unknown category 'AUDIO'",
"validCategories": ["LLM","CODE","VLM","MULTIMODAL","TTS","STT","AUDIO_LLM","IMAGE","UPSCALER","VIDEO"] }
curl -s https://neurobrix.org/api/models/hexgrad/Kokoro-82M
Те же поля, что и в списке, плюс gated, licenseName и licenseUrl. Неизвестная модель возвращает 404 {"error":"Model not found"}.
curl -s https://neurobrix.org/api/models/hexgrad/Kokoro-82M/download
{ "url": "https://neurobrix.org/api/models/hexgrad/Kokoro-82M/file?grant=...",
"fileName": "Kokoro-82M.nbx",
"sha256": "4136f6a6a5c97e16f45a21d3e697b7080f1268b85521f747bd6519b33c77bee8" }
Это единственный вход к модели, и именно этот запрос считается загрузкой. url действителен один час. Проверьте файл после загрузки: sha256sum Kokoro-82M.nbx должен совпадать с sha256.
Закрытые лицензии. Для моделей с лицензией, требующей принятия (gated: true), вызов без принятия возвращает 401 с "code": "LICENSE_LOGIN_REQUIRED". Примите лицензию на странице модели после входа или отправьте заголовок, с которым согласился пользователь терминала:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Вошедший пользователь, не принявший лицензию, получает 403 LICENSE_NOT_ACCEPTED. Скрытая модель даёт 403 MODEL_HIDDEN. См. Лицензии.
url, возвращённый выше, отдаёт контейнер по GET и HEAD:
curl -sI "$URL" # size, X-NBX-SHA256, Accept-Ranges: bytes
curl -s -r 0-9 -D - -o /dev/null "$URL" # 206 Partial Content, Content-Range: bytes 0-9/<size>
Range поддерживается, поэтому загрузки можно возобновлять. Диапазон за пределами файла возвращает 416.X-NBX-SHA256 содержит контрольную сумму всего контейнера. В частичном (206) ответе об этом сообщает X-NBX-SHA256-Scope: whole-container.403 с "code": "GRANT_INVALID". Запросите новое через /download.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel — stable или beta. GET /api/release/download?channel=stable перенаправляет на архив выпуска. Страница установки — neurobrix.org/download.
Далее: Хаб моделей