De website en de neurobrix-CLI lezen dezelfde publieke API. Voor niets hieronder is aanmelden of een token nodig.
https://neurobrix.org/api
Programmatische clients moeten een normale
User-Agent-header meesturen. De edge vóór de Hub antwoordt met 403 op sommige standaard bibliotheekagents.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parameter | Beschrijving |
|---|---|
category |
Een van de tien categorieën: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Tekstzoekopdracht |
page |
Paginanummer, vanaf 1 |
limit |
Resultaten per pagina: 1 tot 100, standaard 12 (waarden boven 100 worden teruggebracht tot 100). De CLI vraagt 100 |
visibility |
all toont ook ingetrokken (verborgen) modellen |
Antwoord:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize is een string (het kan 32 bits overschrijden). visibility is PUBLIC of DEPRECATED (nog te downloaden; visibilityReason geeft de reden). Verborgen modellen ontbreken tenzij visibility=all.
Een onbekende categorie geeft 400 met de geldige lijst:
{ "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
Dezelfde velden als de lijst, plus gated, licenseName en licenseUrl. Een onbekend model geeft 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" }
Dit is de enige toegang tot een model, en dit verzoek telt als een download. De url is een uur geldig. Verifieer het bestand na het downloaden: sha256sum Kokoro-82M.nbx moet gelijk zijn aan sha256.
Afgeschermde licenties. Voor modellen onder een licentie die acceptatie vereist (gated: true) geeft de aanroep zonder acceptatie 401 met "code": "LICENSE_LOGIN_REQUIRED". Accepteer op de modelpagina wanneer u bent aangemeld, of stuur de header mee waarmee een terminalgebruiker heeft geaccepteerd:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Een aangemelde gebruiker die niet heeft geaccepteerd krijgt 403 LICENSE_NOT_ACCEPTED. Een verborgen model geeft 403 MODEL_HIDDEN. Zie Licenties.
De hierboven teruggegeven url serveert de container met GET en 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 wordt ondersteund, zodat downloads kunnen worden hervat. Een bereik buiten het bestand geeft 416.X-NBX-SHA256 bevat de checksum van de hele container. Bij een gedeeltelijk antwoord (206) zegt X-NBX-SHA256-Scope: whole-container dat.403 met "code": "GRANT_INVALID". Vraag een nieuwe aan via /download.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel is stable of beta. GET /api/release/download?channel=stable verwijst door naar het releasearchief. De installatiepagina is neurobrix.org/download.
Volgende: Model Hub