El lloc web i la CLI neurobrix llegeixen la mateixa API pública. No cal iniciar sessió ni cap token per a res del que ve a continuació.
https://neurobrix.org/api
Els clients programàtics han d'enviar una capçalera
User-Agentnormal. La vora que hi ha davant del hub respon 403 a alguns agents de biblioteques per defecte.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Paràmetre | Descripció |
|---|---|
category |
Una de les deu categories: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Cerca de text |
page |
Número de pàgina, a partir d'1 |
limit |
Resultats per pàgina: d'1 a 100, per defecte 12 (els valors per sobre de 100 es limiten a 100). La CLI en demana 100 |
visibility |
all també llista els models retirats (ocults) |
Resposta:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize és una cadena (pot superar els 32 bits). visibility és PUBLIC o DEPRECATED (encara es pot descarregar; visibilityReason en diu el motiu). Els models ocults hi són absents tret que visibility=all.
Una categoria desconeguda retorna 400 amb la llista vàlida:
{ "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
Els mateixos camps que el llistat, més gated, licenseName i licenseUrl. Un model desconegut retorna 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" }
Aquesta és l'única entrada a un model, i la petició és el que compta com a descàrrega. La url és vàlida durant una hora. Verifiqueu el fitxer després de descarregar-lo: sha256sum Kokoro-82M.nbx ha de ser igual a sha256.
Llicències restringides. Per als models amb una llicència que requereix acceptació (gated: true), la crida sense acceptació retorna 401 amb "code": "LICENSE_LOGIN_REQUIRED". Accepteu-la a la pàgina del model havent iniciat sessió, o envieu la capçalera amb què ha acceptat un usuari de terminal:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Un usuari amb sessió iniciada que no ha acceptat rep 403 LICENSE_NOT_ACCEPTED. Un model ocult rep 403 MODEL_HIDDEN. Vegeu Llicències.
La url retornada més amunt serveix el contenidor amb GET i 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 és compatible, de manera que les descàrregues es poden reprendre. Un interval fora del fitxer retorna 416.X-NBX-SHA256 porta la suma de verificació del contenidor sencer. En una resposta parcial (206), X-NBX-SHA256-Scope: whole-container ho indica.403 amb "code": "GRANT_INVALID". Demaneu-ne una de nova 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 és stable o beta. GET /api/release/download?channel=stable redirigeix a l'arxiu de la versió. La pàgina d'instal·lació és neurobrix.org/download.
Següent: Centre de models