اتصال Open WebUI به پیکو هوش

Open WebUI یک رابط چت متن‌باز و خودمیزبان است که می‌توانید روی سرور خودتان اجرا کنید. این برنامه به هر API سازگار با OpenAI وصل می‌شود، بنابراین با افزودن پیکو هوش به‌عنوان یک «اتصال»، همه‌ی مدل‌های کاتالوگ در منوی انتخاب مدل ظاهر می‌شوند.

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

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱اجرا با Docker

   آدرس و کلید را با متغیرهای محیطی بدهید.

   کپی

   docker run -d -p 3000:8080 \
     -e OPENAI_API_BASE_URL=https://api.picoai.ir/v1 \
     -e OPENAI_API_KEY=YOUR_API_KEY \
     -v open-webui:/app/backend/data \
     --name open-webui ghcr.io/open-webui/open-webui:main

2. ۲یا از رابط کاربری

   پس از ورود به‌عنوان ادمین به Admin Settings و بخش Connections بروید، در قسمت OpenAI API یک اتصال تازه با آدرس و کلید اضافه کنید و ذخیره کنید.

   کپی

   URL:  https://api.picoai.ir/v1
   Key:  YOUR_API_KEY

3. ۳انتخاب مدل

   در صفحه‌ی چت، منوی مدل را باز کنید؛ مدل‌های بازگردانده‌شده از /v1/models نمایش داده می‌شوند.

4. ۴محدود کردن مدل‌ها (اختیاری)

   اگر نمی‌خواهید همه‌ی مدل‌ها دیده شوند، در همان بخش اتصال، فهرست شناسه‌ی مدل‌ها را مشخص کنید.

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Open WebUI خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Open WebUI

• برای کاربران چندنفره، سقف ماهانه‌ی کلید را تنظیم کنید تا یک نفر کل موجودی را مصرف نکند.
• ثبت‌نام عمومی را ببندید یا تأیید دستی بگذارید مگر آنکه می‌خواهید سرویس عمومی بدهید.
• داده‌های چت روی سرور خود شما می‌ماند؛ بکاپ volume را فراموش نکنید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.