Die Website und die neurobrix-CLI lesen dieselbe öffentliche API. Für nichts von dem Folgenden ist eine Anmeldung oder ein Token nötig.
https://neurobrix.org/api
Programmatische Clients sollten einen normalen
User-Agent-Header senden. Der Edge-Dienst vor dem Hub antwortet auf manche Standard-Bibliotheks-Agents mit 403.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parameter | Beschreibung |
|---|---|
category |
Eine der zehn Kategorien: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Textsuche |
page |
Seitennummer, ab 1 |
limit |
Ergebnisse pro Seite: 1 bis 100, Standard 12 (Werte über 100 werden auf 100 begrenzt). Die CLI fragt 100 an |
visibility |
all listet auch zurückgezogene (versteckte) Modelle auf |
Antwort:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize ist ein String (er kann 32 Bit überschreiten). visibility ist PUBLIC oder DEPRECATED (weiterhin herunterladbar; visibilityReason nennt den Grund). Versteckte Modelle fehlen, außer bei visibility=all.
Eine unbekannte Kategorie liefert 400 mit der gültigen Liste:
{ "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
Dieselben Felder wie in der Liste, plus gated, licenseName und licenseUrl. Ein unbekanntes Modell liefert 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" }
Dies ist der einzige Zugang zu einem Modell, und die Anfrage selbst zählt als Download. Die url ist eine Stunde lang gültig. Prüfe die Datei nach dem Download: sha256sum Kokoro-82M.nbx muss sha256 entsprechen.
Gesperrte Lizenzen. Bei Modellen unter einer Lizenz, die eine Zustimmung erfordert (gated: true), liefert der Aufruf ohne Zustimmung 401 mit "code": "LICENSE_LOGIN_REQUIRED". Akzeptiere auf der Modellseite, wenn du angemeldet bist, oder sende den Header, mit dem ein Terminal-Benutzer zugestimmt hat:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Ein angemeldeter Benutzer, der nicht akzeptiert hat, erhält 403 LICENSE_NOT_ACCEPTED. Ein verstecktes Modell erhält 403 MODEL_HIDDEN. Siehe Lizenzen.
Die oben zurückgegebene url liefert den Container mit GET und 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 wird unterstützt, sodass Downloads fortgesetzt werden können. Ein Bereich außerhalb der Datei liefert 416.X-NBX-SHA256 trägt die Prüfsumme des gesamten Containers. Bei einer Teilantwort (206) sagt X-NBX-SHA256-Scope: whole-container dies aus.403 mit "code": "GRANT_INVALID". Fordere über /download eine neue an.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel ist stable oder beta. GET /api/release/download?channel=stable leitet zum Release-Archiv weiter. Die Installationsseite ist neurobrix.org/download.
Weiter: Model Hub