Il sito web e la CLI neurobrix leggono la stessa API pubblica. Per tutto ciò che segue non servono accesso né token.
https://neurobrix.org/api
I client programmatici dovrebbero inviare un normale header
User-Agent. Il livello edge davanti all'hub risponde 403 ad alcuni agenti predefiniti di librerie.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parametro | Descrizione |
|---|---|
category |
Una delle dieci categorie: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Ricerca testuale |
page |
Numero di pagina, a partire da 1 |
limit |
Risultati per pagina: da 1 a 100, predefinito 12 (i valori superiori a 100 vengono ridotti a 100). La CLI ne richiede 100 |
visibility |
all elenca anche i modelli ritirati (nascosti) |
Risposta:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize è una stringa (può superare i 32 bit). visibility è PUBLIC o DEPRECATED (ancora scaricabile; visibilityReason ne indica il motivo). I modelli nascosti sono assenti a meno di visibility=all.
Una categoria sconosciuta restituisce 400 con l'elenco valido:
{ "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
Gli stessi campi dell'elenco, più gated, licenseName e licenseUrl. Un modello sconosciuto restituisce 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" }
Questo è l'unico ingresso a un modello, ed è la richiesta a contare come download. L'url è valido per un'ora. Verificare il file dopo il download: sha256sum Kokoro-82M.nbx deve essere uguale a sha256.
Licenze ad accesso controllato. Per i modelli con una licenza che richiede accettazione (gated: true), la chiamata senza accettazione restituisce 401 con "code": "LICENSE_LOGIN_REQUIRED". Accettare nella pagina del modello dopo l'accesso, oppure inviare l'header con cui un utente del terminale ha accettato:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Un utente autenticato che non ha accettato riceve 403 LICENSE_NOT_ACCEPTED. Un modello nascosto riceve 403 MODEL_HIDDEN. Vedere Licenze.
L'url restituito sopra serve il container con GET e 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 è supportato, quindi i download possono essere ripresi. Un intervallo al di fuori del file restituisce 416.X-NBX-SHA256 riporta il checksum dell'intero container. In una risposta parziale (206), X-NBX-SHA256-Scope: whole-container lo indica.403 con "code": "GRANT_INVALID". Richiederne uno nuovo a /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 o beta. GET /api/release/download?channel=stable reindirizza all'archivio del rilascio. La pagina di installazione è neurobrix.org/download.
Successivo: Model Hub