O sítio web e a CLI neurobrix leem a mesma API pública. Não é necessário iniciar sessão nem usar um token para nada do que se segue.
https://neurobrix.org/api
Os clientes programáticos devem enviar um cabeçalho
User-Agentnormal. A camada de borda à frente do hub responde 403 a alguns agentes predefinidos de bibliotecas.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parâmetro | Descrição |
|---|---|
category |
Uma das dez categorias: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Pesquisa de texto |
page |
Número da página, a partir de 1 |
limit |
Resultados por página: 1 a 100, predefinição 12 (valores acima de 100 são limitados a 100). A CLI pede 100 |
visibility |
all lista também os modelos retirados (ocultos) |
Resposta:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize é uma string (pode exceder 32 bits). visibility é PUBLIC ou DEPRECATED (ainda descarregável; visibilityReason indica o motivo). Os modelos ocultos estão ausentes, a menos que use visibility=all.
Uma categoria desconhecida devolve 400 com a lista 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
Os mesmos campos da listagem, mais gated, licenseName e licenseUrl. Um modelo desconhecido devolve 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" }
Esta é a única entrada para um modelo, e o pedido é o que conta como uma descarga. O url é válido durante uma hora. Verifique o ficheiro depois de o descarregar: sha256sum Kokoro-82M.nbx tem de ser igual a sha256.
Licenças com acesso restrito. Para modelos com uma licença que exige aceitação (gated: true), a chamada sem aceitação devolve 401 com "code": "LICENSE_LOGIN_REQUIRED". Aceite na página do modelo com a sessão iniciada, ou envie o cabeçalho com que um utilizador de terminal aceitou:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Um utilizador com sessão iniciada que não aceitou recebe 403 LICENSE_NOT_ACCEPTED. Um modelo oculto recebe 403 MODEL_HIDDEN. Veja Licenças.
O url devolvido acima serve o contentor com 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 é suportado, pelo que as descargas podem ser retomadas. Um intervalo fora do ficheiro devolve 416.X-NBX-SHA256 transporta o checksum do contentor inteiro. Numa resposta parcial (206), X-NBX-SHA256-Scope: whole-container di-lo.403 com "code": "GRANT_INVALID". Peça uma 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": "..." }
O channel é stable ou beta. GET /api/release/download?channel=stable redireciona para o arquivo da versão. A página de instalação é neurobrix.org/download.
Seguinte: Hub de Modelos