المصادقة
أرسل المفتاح في الترويسة Authorization: Bearer ghn_… أو x-api-key.
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /api/public/v1/models | قائمة النماذج (مفتاح ghn_) |
| POST | /api/public/v1/chat/completions | محادثة متوافقة مع OpenAI (مفتاح ghn_) |
| GET | /api/hub/catalog | كتالوج المنصة: بيانات النماذج + الحالة الحية (nrel) + المخزون |
| GET | /api/hub/usage?days=30 | سجل الاستهلاك المجمّع |
| POST | /api/public/v1/eval/ingest | استقبال نتائج Test & Eval من site-ai |
| POST | /api/public/v1/usage/ingest | استقبال الاستهلاك من الأجهزة |
| POST | /api/public/v1/training/ingest | تقدم التدريب من Training Lab (صلاحية training:ingest) |
| GET | /api/public/v1/training/jobs | قائمة مهام التدريب (قراءة فقط) |
curl
curl https://groupe-hn.com/api/public/v1/chat/completions \
-H "Authorization: Bearer ghn_…" -H "content-type: application/json" \
-d '{"model":"GHN-01","messages":[{"role":"user","content":"مرحبا"}]}'Python (openai)
from openai import OpenAI
c = OpenAI(base_url="https://groupe-hn.com/api/public/v1", api_key="ghn_…")
r = c.chat.completions.create(model="GHN-01", messages=[{"role":"user","content":"مرحبا"}])
print(r.choices[0].message.content)JavaScript
const r = await fetch("https://groupe-hn.com/api/public/v1/chat/completions", {
method: "POST",
headers: { Authorization: "Bearer ghn_…", "content-type": "application/json" },
body: JSON.stringify({ model: "GHN-01", messages: [{ role: "user", content: "مرحبا" }] }),
});VS Code (Continue) / Cursor / NAWAT Studio
Base URL: https://groupe-hn.com/api/public/v1 API key : ghn_… Model : GHN-01 (أو M### أو اسم النموذج)
الأخطاء
صيغة OpenAI: {"error":{"message","type"}} — 401 مفتاح غير صالح · 403 مفتاح ملغى أو نموذج غير مسموح · 502 المحرك غير متاح.