آموزش اتصال API هوش مصنوعی Mindbase به New API (کانال OpenAI)
New API (نسل جدید One-API) گتوی خودمیزبان محبوب تیمهاست: کانالهای مدل میسازید، کلید مجازی صادر میکنید و مصرف را میسنجید. مایندبیس بهعنوان کانال OpenAI با آدرس گیتوی ثبت میشود و رابط کنسول انگلیسی، برای تیمهای چندزبانه از جمله فارسیزبانها قابل استفاده است.
پیشنیازها
- نصب New API با Docker.
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
New APIتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات New API جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: ساخت کانال
کنسول (پیشفرض 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 گروه، مدلهای مجاز و سقف مصرف میگیرد؛ مایندبیس مثل هر کانال دیگری配额 میخورد.