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

n8n ابزار اتوماسیون گردش‌کار با گره‌های آماده است. اعتبارنامه‌ی OpenAI در n8n فیلدی به نام Base URL دارد؛ اگر آن را روی آدرس پیکو هوش بگذارید، گره‌های OpenAI و Chat Model در بخش AI به دروازه‌ی ما می‌روند. گره HTTP Request هم به‌عنوان راه جایگزین همیشه در دسترس است.

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

پیش‌نیازها

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

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

1. ۱ساخت اعتبارنامه

   در Credentials نوع OpenAI را بسازید.

   کپی

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

2. ۲استفاده در گره Chat Model

   در گردش‌کار AI، گره OpenAI Chat Model را اضافه و مدل را به‌صورت دستی (Expression یا ID) بنویسید، مثلاً gpt-6-sol.

3. ۳راه جایگزین: HTTP Request

   یک گره HTTP Request با تنظیمات زیر بسازید.

   کپی

   Method: POST
   URL: https://api.picoai.ir/v1/chat/completions
   Authentication: Header Auth (Authorization: Bearer YOUR_API_KEY)
   Body (JSON):
   {
     "model": "gpt-6-sol",
     "messages": [{"role": "user", "content": "{{ $json.text }}"}]
   }

4. ۴خواندن پاسخ

   در گره بعدی مقدار choices[0].message.content را بردارید.

   کپی

   {{ $json.choices[0].message.content }}

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

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

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

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

• گردش‌کارهایی که زیاد اجرا می‌شوند را با مدل اقتصادی بسازید؛ هزینه با تعداد اجرا ضرب می‌شود.
• برای خطاهای موقت گزینه‌ی Retry On Fail را در گره روشن کنید.
• کلید را فقط در Credentials نگه دارید، نه داخل خود گردش‌کار.

عیب‌یابی

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

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