Le site web et la CLI neurobrix lisent la même API publique. Aucune connexion ni aucun jeton n'est nécessaire pour ce qui suit.
https://neurobrix.org/api
Les clients programmatiques doivent envoyer un en-tête
User-Agentnormal. Le point d'entrée placé devant le hub répond 403 à certains agents de bibliothèques par défaut.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Paramètre | Description |
|---|---|
category |
L'une des dix catégories : LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Recherche textuelle |
page |
Numéro de page, à partir de 1 |
limit |
Résultats par page : de 1 à 100, 12 par défaut (les valeurs supérieures à 100 sont ramenées à 100). La CLI demande 100 |
visibility |
all liste aussi les modèles retirés (masqués) |
Réponse :
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize est une chaîne (il peut dépasser 32 bits). visibility vaut PUBLIC ou DEPRECATED (toujours téléchargeable ; visibilityReason dit pourquoi). Les modèles masqués sont absents sauf avec visibility=all.
Une catégorie inconnue renvoie 400 avec la liste valide :
{ "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
Mêmes champs que la liste, plus gated, licenseName et licenseUrl. Un modèle inconnu renvoie 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" }
C'est l'unique point d'entrée vers un modèle, et c'est cette requête qui compte comme un téléchargement. L'url est valable une heure. Vérifiez le fichier après le téléchargement : sha256sum Kokoro-82M.nbx doit être égal à sha256.
Licences à accès conditionné. Pour les modèles sous une licence qui exige une acceptation (gated: true), l'appel sans acceptation renvoie 401 avec "code": "LICENSE_LOGIN_REQUIRED". Acceptez sur la page du modèle une fois connecté, ou envoyez l'en-tête avec lequel un utilisateur de terminal a accepté :
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Un utilisateur connecté qui n'a pas accepté reçoit 403 LICENSE_NOT_ACCEPTED. Un modèle masqué reçoit 403 MODEL_HIDDEN. Voir Licences.
L'url renvoyée ci-dessus sert le conteneur avec GET et 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 est pris en charge, les téléchargements peuvent donc être repris. Une plage hors du fichier renvoie 416.X-NBX-SHA256 porte la somme de contrôle du conteneur entier. Sur une réponse partielle (206), X-NBX-SHA256-Scope: whole-container l'indique.403 avec "code": "GRANT_INVALID". Demandez-en une nouvelle à /download.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel vaut stable ou beta. GET /api/release/download?channel=stable redirige vers l'archive de la version. La page d'installation est neurobrix.org/download.
Suivant : Hub de modèles