مستندات API

۱. ثبت‌نام

از صفحه ثبت‌نام با ایمیل و رمز عبور (حداقل ۸ کاراکتر) حساب بسازید. اگر سرویس ایمیل فعال باشد، لینک تأیید برای شما ارسال می‌شود و تأیید ایمیل پیش از خرید الزامی است.

۲. خرید سرویس

• در داشبورد به «خرید سرویس» بروید: سرور ۱ پلن‌های اعتبار تومانی و سرور ۲ پلن‌های اشتراک توکنی دارد.
• قیمت پلن‌ها دلاری است و همان لحظه با نرخ لحظه‌ای USDT به تومان قطعی می‌شود.
• سفارش ایجاد می‌شود و دستورالعمل پرداخت نمایش داده می‌شود.
• پس از پرداخت، شماره پیگیری/مرجع تراکنش را در صفحه سفارش ثبت کنید.
• پس از بررسی و تأیید مدیر، سرویس به‌صورت خودکار فعال می‌شود. تصویر رسید به‌تنهایی مدرک پرداخت محسوب نمی‌شود.

۳. کلید سرویس

کلید به‌صورت خودکار ساخته می‌شود: پس از تأیید خرید، کلید سرویس شما فعال و از طریق ربات تلگرام در اختیار شما قرار می‌گیرد. کلید فقط یک‌بار نمایش داده می‌شود؛ آن را در جای امن ذخیره کنید. برای تمدید یا شارژ مجدد، همان سرویس را از بخش خرید (یا ربات) دوباره بخرید تا روی همان کلید شارژ شود.

۴. آدرس پایه و احراز هویت

Base URL: https://api.myapiplus.ir/v1
Authorization: Bearer sk-...

۵. مدل‌ها و مسیرها

• POST /chat/completions — تولید پاسخ گفتگو (فرمت OpenAI)
• GET /models — فهرست مدل‌های مجاز برای کلید شما

مسیرهای دیگر (embedding، تصویر و …) فقط در صورتی که در ستون «قابلیت‌ها» برای یک مدل ذکر شده باشد پشتیبانی می‌شوند. فهرست مدل‌های فعال: مدل‌ها و قیمت‌ها.

۶. نمونه Python (SDK سازگار با OpenAI)

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://api.myapiplus.ir/v1",
    api_key="sk-...",  # کلید اختصاصی شما
)

resp = client.chat.completions.create(
    model="glm-5.3-abliterated",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(resp.choices[0].message.content)

۷. نمونه cURL

curl https://api.myapiplus.ir/v1/chat/completions \
  -H "Authorization: Bearer $IS26_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-abliterated",
    "messages": [{"role": "user", "content": "سلام!"}]
  }'

۸. خطاها و رفع اشکال

۹. مصرف، محدودیت و قیمت

• سرور ۱: هزینه هر درخواست بر اساس توکن‌های ورودی و خروجی و قیمت دلاری هر مدل (به ازای ۱ میلیون توکن) محاسبه و از اعتبار کیف پول کسر می‌شود.
• سرور ۲: مصرف به «توکن وزنی» شمرده می‌شود (هر مدل ضریب خودش را دارد) و از سهمیه پلن توکنی کسر می‌شود.
• مصرف به‌صورت دوره‌ای از درگاه همگام‌سازی می‌شود؛ بنابراین ارقام داشبورد با کمی تأخیر به‌روز می‌شوند.
• اگر موجودی به صفر یا کمتر برسد، کلیدها مسدود می‌شوند. به‌دلیل همگام‌سازی دوره‌ای، ممکن است موجودی به‌طور موقت کمی منفی شود که از خرید بعدی کسر خواهد شد.

۱۰. امنیت کلید API

• کلید را هرگز در کد سمت مرورگر یا اپلیکیشن موبایل قرار ندهید؛ از سرور خود درخواست بزنید.
• کلید را در متغیر محیطی نگه دارید و در مخزن git ثبت نکنید.
• برای هر پروژه کلید جدا بسازید و مدل‌ها را محدود کنید.
• در صورت افشا، فوراً کلید را باطل کنید.