يقرأ الموقع الإلكتروني وسطر الأوامر neurobrix واجهة البرمجة العامة نفسها. لا حاجة إلى تسجيل دخول أو رمز لأي شيء أدناه.
https://neurobrix.org/api
ينبغي أن ترسل العملاء البرمجية ترويسة
User-Agentعادية. فالحافة (edge) أمام الـ Hub ترد بـ 403 على بعض وكلاء المكتبات الافتراضية.
curl -s "https://neurobrix.org/api/models?category=IMAGE&q=flux&limit=20"
| المعامل | الوصف |
|---|---|
category |
إحدى الفئات العشر: LLM, CODE, VLM, MULTIMODAL, TTS, STT, AUDIO_LLM, IMAGE, UPSCALER, VIDEO |
q |
بحث نصي |
page |
رقم الصفحة، بدءًا من 1 |
limit |
النتائج في الصفحة: من 1 إلى 100، الافتراضي 12 (تُقتطع القيم الأكبر من 100 إلى 100). يطلب سطر الأوامر 100 |
visibility |
تُدرج القيمة all أيضًا النماذج المسحوبة (المخفية) |
الاستجابة:
{ "models": [ { "slug": "org/name", "category": "TTS", "license": "mit", "fileSize": "370004323",
"sha256": "...", "downloadCount": 0, "visibility": "PUBLIC", "...": "..." } ],
"total": 47, "page": 1, "limit": 12 }
fileSize سلسلة نصية (فقد يتجاوز 32 بت). وvisibility هي PUBLIC أو DEPRECATED (ما زال قابلًا للتنزيل؛ ويذكر visibilityReason السبب). النماذج المخفية غائبة ما لم تستخدم visibility=all.
تعيد الفئة غير المعروفة 400 مع القائمة الصحيحة:
{ "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
الحقول نفسها كما في القائمة، إضافة إلى gated وlicenseName وlicenseUrl. يعيد النموذج غير المعروف 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" }
هذا هو المدخل الوحيد إلى النموذج، والطلب هو ما يُحتسب تنزيلًا. العنوان url صالح لمدة ساعة. تحقق من الملف بعد التنزيل: يجب أن يساوي sha256sum Kokoro-82M.nbx قيمة sha256.
التراخيص المقيّدة. بالنسبة للنماذج ذات الترخيص الذي يحتاج إلى قبول (gated: true)، يعيد الطلب دون قبول 401 مع "code": "LICENSE_LOGIN_REQUIRED". اقبل في صفحة النموذج عند تسجيل الدخول، أو أرسل الترويسة التي قبل بها مستخدم الطرفية:
curl -s -H "X-License-Accepted: true" https://neurobrix.org/api/models/zai-org/CogVideoX-5b-I2V/download
المستخدم المسجَّل الدخول الذي لم يقبل يحصل على 403 مع LICENSE_NOT_ACCEPTED. والنموذج المخفي يحصل على 403 مع MODEL_HIDDEN. انظر التراخيص.
العنوان url المُعاد أعلاه يقدّم الحاوية عبر GET و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 مدعومة، لذلك يمكن استئناف التنزيلات. النطاق خارج الملف يعيد 416.X-NBX-SHA256 المجموع الاختباري للحاوية كاملةً. وفي الاستجابة الجزئية (206) تقول X-NBX-SHA256-Scope: whole-container ذلك.403 مع "code": "GRANT_INVALID". اطلب واحدة جديدة من /download.503.curl -s "https://neurobrix.org/api/release/latest?channel=stable"
{ "version": "0.6.15", "channel": "stable", "pypiUrl": "...", "zipKey": "...", "sha256": "...",
"releaseNotesUrl": "...", "publishedAt": "..." }
channel هي stable أو beta. ويعيد GET /api/release/download?channel=stable توجيهًا إلى أرشيف الإصدار. وصفحة التثبيت هي neurobrix.org/download.
التالي: مركز النماذج