Web sitesi ve neurobrix CLI aynı herkese açık API'yi okur. Aşağıdakilerin hiçbiri için oturum açmak ya da token kullanmak gerekmez.
https://neurobrix.org/api
Programatik istemciler normal bir
User-Agentbaşlığı göndermelidir. Hub'ın önündeki uç, bazı varsayılan kütüphane ajanlarına 403 yanıtı verir.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| Parametre | Açıklama |
|---|---|
category |
On kategoriden biri: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
Metin araması |
page |
Sayfa numarası, 1'den başlar |
limit |
Sayfa başına sonuç: 1 ila 100, varsayılan 12 (100'ün üzerindeki değerler 100'e indirilir). CLI 100 ister |
visibility |
all, geri çekilmiş (hidden) modelleri de listeler |
Yanıt:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize bir dizgedir (32 bit'i aşabilir). visibility değeri PUBLIC ya da DEPRECATED'dir (hâlâ indirilebilir; visibilityReason nedenini söyler). Gizli modeller visibility=all olmadıkça görünmez.
Bilinmeyen bir kategori, geçerli listeyle birlikte 400 döndürür:
{ "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
Listeyle aynı alanlar, artı gated, licenseName ve licenseUrl. Bilinmeyen bir model 404 {"error":"Model not found"} döndürür.
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" }
Bu, bir modele açılan tek kapıdır ve istek, bir indirme olarak sayılan şeydir. url bir saat geçerlidir. İndirdikten sonra dosyayı doğrulayın: sha256sum Kokoro-82M.nbx çıktısı sha256 değerine eşit olmalıdır.
Kapılı lisanslar. Kabul gerektiren bir lisans altındaki modeller için (gated: true), kabulsüz çağrı "code": "LICENSE_LOGIN_REQUIRED" ile 401 döndürür. Oturum açıkken model sayfasında kabul edin ya da bir terminal kullanıcısının kabul ettiğini belirten başlığı gönderin:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
Oturum açmış ancak kabul etmemiş bir kullanıcı 403 LICENSE_NOT_ACCEPTED alır. Gizli bir model 403 MODEL_HIDDEN alır. Lisanslar sayfasına bakın.
Yukarıda döndürülen url, kapsayıcıyı GET ve HEAD ile sunar:
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 desteklenir; böylece indirmeler sürdürülebilir. Dosya dışındaki bir aralık 416 döndürür.X-NBX-SHA256, kapsayıcının tamamının sağlama toplamını taşır. Kısmi (206) yanıtta X-NBX-SHA256-Scope: whole-container bunu belirtir."code": "GRANT_INVALID" ile 403 olur. /download üzerinden yenisini isteyin.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel değeri stable ya da beta'dır. GET /api/release/download?channel=stable, sürüm arşivine yönlendirir. Kurulum sayfası neurobrix.org/download adresindedir.
Sonraki: Model Hub