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

Dify پلتفرم متن‌باز ساخت اپلیکیشن‌های هوش مصنوعی (چت‌بات، workflow، RAG) با رابط بصری است. در بخش Model Provider ارائه‌دهنده‌ای به نام OpenAI-API-compatible وجود دارد که برای هر API سازگار با OpenAI استفاده می‌شود. نام مدل، کلید و آدرس endpoint را وارد می‌کنید.

پس از افزودن مدل، می‌توانید آن را در هر اپلیکیشن Dify انتخاب کنید و در workflowها مدل‌های مختلف را در گره‌های مختلف به‌کار ببرید.

پیش‌نیازها

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

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

1. ۱باز کردن Model Provider

   از منوی کاربری به Settings و سپس Model Provider بروید.

2. ۲نصب ارائه‌دهنده

   در لیست ارائه‌دهنده‌ها «OpenAI-API-compatible» را پیدا کنید (در نسخه‌های جدید ممکن است از مارکت‌پلیس افزونه نصب شود) و Add Model را بزنید.

3. ۳وارد کردن مشخصات

   فیلدها را پر کنید.

   کپی

   Model Type:      LLM
   Model Name:      gpt-6-sol
   API Key:         YOUR_API_KEY
   API endpoint URL: https://api.picoai.ir/v1
   Model context size: 128000
   Support vision:  بسته به مدل

4. ۴استفاده در اپ

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

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

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

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

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

• برای هر مدل یک ردیف جداگانه اضافه کنید؛ نام باید دقیقاً با شناسه‌ی کاتالوگ برابر باشد.
• اندازه‌ی context را مطابق همان مدل در کاتالوگ بنویسید تا Dify متن را درست برش بزند.
• پایگاه دانش (Knowledge) به مدل embedding نیاز دارد که پیکو هوش ندارد؛ برای آن از ارائه‌دهنده‌ی دیگری استفاده کنید.

عیب‌یابی

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

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