آموزش اتصال API هوش مصنوعی Mindbase به New API (کانال OpenAI)

New API (نسل جدید One-API) گت‌وی خودمیزبان محبوب تیم‌هاست: کانال‌های مدل می‌سازید، کلید مجازی صادر می‌کنید و مصرف را می‌سنجید. مایندبیس به‌عنوان کانال OpenAI با آدرس گیت‌وی ثبت می‌شود و رابط کنسول انگلیسی، برای تیم‌های چندزبانه از جمله فارسی‌زبان‌ها قابل استفاده است.

پیش‌نیازها

  • نصب New API با Docker.
  • کلید API مایندبیس (گام صفر پایین).

گام صفر: دریافت API Key و Base URL از مایندبیس

قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:

  1. وارد حساب کاربری خود در mindbase.ir شوید (ثبت‌نام رایگان است).
  2. از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
  3. روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً New API تا بعداً بدانید این کلید مال کدام ابزار است.
  4. مقدار کلید را کپی کنید — این کلید با پیشوند mb_ شروع می‌شود.
  5. Base URL نیز در همین صفحه نمایش داده می‌شود: https://api.mindbase.ir/v1
دریافت کلید API و Base URL از پنل کاربری مایندبیس

در ادامه همین دو مقدار را در تنظیمات New API جای‌گذاری می‌کنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدل‌ها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدل‌های مایندبیس قابل مشاهده است.

مرحله اول: ساخت کانال

محیط واقعی New API — آموزش تنظیم اتصال به مایندبیس

کنسول (پیش‌فرض localhost:3000) → بخش Channels → Add Channel. Type را OpenAI و نام را MindBase بگذارید؛ در فیلد Key کلید mb_… را پیست کنید. آدرس کانال را https://api.mindbase.ir/v1 قرار دهید (در کانال‌های سفارشی آدرس پر می‌شود؛ فقط آدرس رسمی OpenAI باید بدون /v1 بماند).

docker run --name new-api -d --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v "$(pwd)/data:/data" \
  calciumion/new-api:latest
# کنسول: :3000 — کانال OpenAI با Base URL و کلید mb_*
# ابزارها: POST http://host:3000/v1/chat/completions با کلید مجازی

مرحله دوم: مدل‌ها و تست

در بخش مدل‌ها، MindBase را ثبت کنید (دکمه‌های پرکردن خودکار در لیست رسمی نیست؛ دستی وارد کنید) و در صورت نیاز نام جایگزین با Model Mapping تعریف کنید. کانال را Test کنید — پاسخ سالم یعنی مسیر باز است.

مرحله سوم: صدور کلید و اتصال ابزارها

از بخش Tokens یک Add Tokens بسازید. حالا هر ابزاری را با Base URL http://host:3000/v1 و همان کلید مجازی به گیت‌وی وصل کنید؛ نام مدل همان MindBase است.

نکات مهم

  • پروتکل‌ها: RelayKit بین OpenAI/Anthropic/Gemini/Responses تبدیل می‌کند؛ ابزارهای پروتکلی ممکن است کامل منتقل نشوند.
  • برون‌سپاری امن: کنسول را پشت HTTPS و پروکسی معکوس با پشتیبانی استریم/WebSocket بگذارید.
  • نام برچسب‌ها: برخی برچسب‌های انگلیسی کنسول از ترجمه رسمی cn می‌آید؛ اگر معادل فارسی/انگلیسی دقیق نمی‌دیدید، ترتیب فیلدها همان است.

رفع مشکلات رایج

  • ۴۰۴ روی تست: آدرس کانال را با /v1 بدهید؛ آدرس رسمی OpenAI استثناست.
  • ۴۰۱ روی تست: کلید mb_* و فیلد درست (Key کانال) را چک کنید.
  • پاسخ استریم قطع: پروکسی معکوس باید WebSocket/استریم را پاس کند.

جمع‌بندی

New API با یک کانال OpenAI، مایندبیس را وارد گت‌وی خودمیزبان می‌کند: کلید مجازی، سهمیه و گزارش مصرف برای کل تیم — با رابط انگلیسی و رله چندپروتکوله.

سوالات متداول

فرق New API با One-API؟

New API همان فارک فارسی‌پسندِ One-API با رابط انگلیسی، پروتکل‌های چندگانه و رله استریم است؛ مسیر کانال‌ها یکی است.

مدل نگاشت اسم؟

فیلد Model Mapping (json) نام درخواستی را به نام واقعی اپ‌استریم تبدیل می‌کند — مثلاً برای مدل‌های GLM.

سهمیه‌بندی تیم؟

هر Token گروه، مدل‌های مجاز و سقف مصرف می‌گیرد؛ مایندبیس مثل هر کانال دیگری配额 می‌خورد.