اتصال LibreChat به پیکو هوش

LibreChat رابط چت متن‌باز با پشتیبانی از چند ارائه‌دهنده و حساب کاربری است. برای APIهای سازگار با OpenAI، فایل librechat.yaml بخشی به نام endpoints.custom دارد که هر ارائه‌دهنده با name، apiKey، baseURL و فهرست مدل‌ها در آن تعریف می‌شود.

با این تنظیم یک گزینه‌ی «PicoAi» کنار بقیه‌ی ارائه‌دهنده‌ها در رابط ظاهر می‌شود و فهرست مدل‌ها می‌تواند به‌صورت خودکار از /v1/models خوانده شود.

پیش‌نیازها

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

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

1. ۱کلید را در env بگذارید

   در فایل .env کنار docker-compose، متغیر کلید را اضافه کنید.

   کپی

   PICOAI_API_KEY=YOUR_API_KEY

2. ۲تعریف Custom Endpoint

   به librechat.yaml این بخش را اضافه کنید (فایل کنار docker-compose قرار دارد).

   کپی

   endpoints:
     custom:
       - name: "PicoAi"
         apiKey: "${PICOAI_API_KEY}"
         baseURL: "https://api.picoai.ir/v1"
         models:
           default: ["gpt-6-sol", "claude-sonnet-5-5", "deepseek-v4-pro"]
           fetch: true
         titleConvo: true
         titleModel: "gpt-6-sol"
         modelDisplayLabel: "PicoAi"

3. ۳اتصال فایل به کانتینر

   در docker-compose.override.yml فایل librechat.yaml را به کانتینر api نگاشت کنید و سرویس را دوباره بالا بیاورید.

   کپی

   services:
     api:
       volumes:
         - type: bind
           source: ./librechat.yaml
           target: /app/librechat.yaml

4. ۴راه‌اندازی دوباره

   کانتینرها را بازسازی کنید و در رابط، PicoAi را از منوی ارائه‌دهنده انتخاب کنید.

   کپی

   docker compose down && docker compose up -d

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

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

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

نکته‌های کاربردی برای LibreChat

• نام بخش (name) را یکتا بگذارید و پس از انتشار تغییر ندهید چون در گفتگوهای ذخیره‌شده ارجاع داده می‌شود.
• با fetch: true فهرست مدل همیشه به‌روز می‌ماند؛ اگر فهرست بلند است، چند مدل مهم را در default بگذارید.
• سایر گزینه‌ها (dropParams, headers) در مستندات رسمی LibreChat توضیح داده شده است؛ نسخه‌ی خود را بررسی کنید.

عیب‌یابی

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

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