مستندات API

این هاب یک لایهٔ رپر روی سرویس‌های هوش مصنوعی است. برای استفاده، از ادمین یک توکن اختصاصی دریافت کنید و درخواست‌های خود را به‌جای سرویس بالادستی، به این پروژه بفرستید.

۱. دریافت توکن

1. ادمین در بخش کلاینت‌ها یک کلاینت برای شما می‌سازد.
2. در بخش توکن‌ها، یک توکن جدید صادر می‌کند.
3. مقدار خام توکن فقط یک‌بار نمایش داده می‌شود؛ آن را در جای امن نگه دارید.

۲. سرویس‌های فعال

۳. احراز هویت

همهٔ endpointهای سرویس نیاز به هدر زیر دارند:

Authorization: Bearer hub_YOUR_TOKEN

۴. مثال curl — جمای گیتی

curl -X POST "https://aihub.mohaami.ir/api/v1/services/gitti-gemma/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hub_YOUR_TOKEN" \
  -d '{
    "model": "gemma",
    "messages": [
      {
        "role": "system",
        "content": "یک جمله خلاقانه متفاوت بین ۵ تا ۱۰ کلمه بر اساس دسته‌بندی ورودی تولید کن. فقط متن جمله را برگردان."
      },
      {
        "role": "user",
        "content": "duel"
      }
    ],
    "stream": false,
    "max_tokens": 128,
    "temperature": 0.8,
    "top_p": 1.0
  }'

۵. پارامترهای body

۶. سایر endpointها

• GET https://aihub.mohaami.ir/api/v1/health — بدون توکن
• GET https://aihub.mohaami.ir/api/v1/services — لیست سرویس‌ها (نیاز به توکن)

۷. کدهای خطا