El sitio web y la CLI neurobrix leen la misma API pública. No se necesita inicio de sesión ni token para nada de lo que sigue.
https://neurobrix.org/api
Los clientes programáticos deben enviar una cabecera
User-Agentnormal. El borde situado delante del hub responde 403 a algunos agentes de biblioteca predeterminados.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parámetro | Descripción |
|---|---|
category |
Una de las diez categorías: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Búsqueda de texto |
page |
Número de página, desde 1 |
limit |
Resultados por página: de 1 a 100, por defecto 12 (los valores superiores a 100 se limitan a 100). La CLI pide 100 |
visibility |
all lista también los modelos retirados (ocultos) |
Respuesta:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize es una cadena (puede superar los 32 bits). visibility es PUBLIC o DEPRECATED (sigue siendo descargable; visibilityReason explica el motivo). Los modelos ocultos no aparecen salvo con visibility=all.
Una categoría desconocida devuelve 400 con la lista de las válidas:
{ "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
Los mismos campos que en el listado, más gated, licenseName y licenseUrl. Un modelo desconocido devuelve 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" }
Es la única entrada a un modelo, y esta petición es lo que cuenta como una descarga. La url es válida durante una hora. Verifica el archivo tras descargarlo: sha256sum Kokoro-82M.nbx debe ser igual a sha256.
Licencias con acceso restringido. Para los modelos con una licencia que requiere aceptación (gated: true), la llamada sin aceptación devuelve 401 con "code": "LICENSE_LOGIN_REQUIRED". Acepta en la página del modelo con la sesión iniciada, o envía la cabecera con la que un usuario de terminal ha aceptado:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Un usuario con sesión iniciada que no ha aceptado recibe 403 LICENSE_NOT_ACCEPTED. Un modelo oculto recibe 403 MODEL_HIDDEN. Consulta Licencias.
La url devuelta arriba sirve el contenedor con GET y 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á soportado, de modo que las descargas se pueden reanudar. Un rango fuera del archivo devuelve 416.X-NBX-SHA256 lleva la suma de comprobación del contenedor completo. En una respuesta parcial (206), X-NBX-SHA256-Scope: whole-container lo indica.403 con "code": "GRANT_INVALID". Solicita una nueva 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 es stable o beta. GET /api/release/download?channel=stable redirige al archivo de la versión. La página de instalación es neurobrix.org/download.
Siguiente: Hub de modelos