n8n

n8n ابزار خودکارسازی کارهاست که روی سرور خودتان هم نصب می‌شود: با کشیدن و وصل کردن گره‌ها (Node) گردش‌کاری می‌سازید که مثلاً ایمیل تازه را می‌خواند، با هوش مصنوعی خلاصه می‌کند و در تلگرام می‌فرستد. گره‌های هوش مصنوعی n8n با Credential نوع OpenAI کار می‌کنند و این Credential فیلد Base URL دارد؛ پس با کلید گیسو، Claude، Gemini، GPT و DeepSeek همه در همان گره‌ها در دسترس‌اند.

ساختن Credential

1. Credential تازه

   در n8n از Credentials (یا از داخل هر گره OpenAI) گزینهٔ Create credential را بزنید و نوع OpenAI را انتخاب کنید.

2. کلید و نشانی

   کلید گیسو را در API Key و https://gisoo.pro/api/v1 را در Base URL بگذارید. فیلد سازمان (Organization ID) را خالی بگذارید.

3. ذخیره

   نامی مثل «Gisoo» بدهید و ذخیره کنید. حالا همهٔ گره‌های OpenAI می‌توانند از همین Credential استفاده کنند.

AI Agent و OpenAI Chat Model

برای ساختن ایجنت یا زنجیرهٔ ساده، گره اصلی (AI Agent یا Basic LLM Chain) را بگذارید و زیرگره OpenAI Chat Model را به آن وصل کنید:

1. Credential

   همان Credential گیسو را انتخاب کنید.

2. Model

   حالت By ID را بزنید و شناسهٔ مدل را بنویسید. فهرست کشویی ممکن است فقط نام‌های OpenAI را نشان دهد؛ با By ID هر مدل کاتالوگ، از جمله openrouter/anthropic/claude-sonnet-5.5، قابل انتخاب است.

3. Options

   Maximum Number of Tokens را بگذارید (مثلاً ۱۰۰۰)؛ هم هزینه را محدود می‌کند و هم مبلغی را که پیش از هر درخواست کنار گذاشته می‌شود. Timeout را ۱۲۰ ثانیه و Max Retries را ۲ بگذارید.

4. ابزارها

   هر ابزاری که به AI Agent وصل کنید (HTTP Request، Google Sheets، کد) از راه فراخوانی ابزار صدا زده می‌شود؛ مدلی بگذارید که ابزار را خوب صدا می‌زند.

اگر در نسخهٔ n8n شما گزینهٔ استفاده از Responses API در این گره هست، خاموشش بگذارید؛ آن مسیر در گیسو فقط مدل‌های OpenAI را می‌پذیرد.

کدام مدل را بگذارید

شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.

امبدینگ و پایگاه برداری

برای ساختن RAG (پرسش از سندهای خودتان)، زیرگره Embeddings OpenAI را با همان Credential به گره پایگاه برداری (مثل Simple Vector Store، Qdrant یا PGVector) وصل کنید و مدل را text-embedding-3-small بگذارید. یک مدل امبدینگ را برای نوشتن و خواندن یک پایگاه نگه دارید؛ بردارهای دو مدل مختلف با هم قابل مقایسه نیستند.

راه جایگزین: گره HTTP Request

برای endpointهایی که گره آماده ندارند (ساخت تصویر، متن به گفتار، موسیقی) یا وقتی کنترل کامل بدنه را می‌خواهید، از گره HTTP Request استفاده کنید. ساده‌ترین راه: دستور curl زیر را در گزینهٔ Import cURL همان گره بچسبانید.

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

curl https://gisoo.pro/api/v1/chat/completions \
  -H "Authorization: Bearer sk-gisoo-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4.1-mini", "messages": [{"role": "user", "content": "Summarise this email in one line"}]}'

1. احراز هویت

   بعد از وارد کردن، Authentication را Generic Credential Type و Header Auth بگذارید: نام Authorization و مقدار Bearer sk-gisoo-v1-…. هدر دستی را پاک کنید تا کلید در خود گردش‌کار نماند.

2. بدنه

   Body Content Type را JSON و Specify Body را Using JSON بگذارید. با JSON.stringify، متنی که نقل‌قول یا خط تازه دارد بدنه را خراب نمی‌کند.

{
  "model": "gpt-4.1-mini",
  "max_tokens": 500,
  "messages": [
    { "role": "system", "content": "Answer in Persian, in one short paragraph." },
    { "role": "user", "content": {{ JSON.stringify($json.question) }} }
  ]
}

{
  "model": "gpt-image-1-mini",
  "prompt": {{ JSON.stringify($json.prompt) }},
  "size": "1024x1024"
}

پاسخ گفت‌وگو در choices[0].message.content است و پاسخ تصویر در data[0].b64_json؛ با گره Convert to File آن را به فایل تبدیل کنید (ساخت تصویر).

چه چیزهایی کار نمی‌کند

گره OpenAI عملیات‌هایی هم دارد که به بخش‌هایی از API شرکت OpenAI وابسته‌اند و در گیسو نیستند: Assistants، بارگذاری فایل و Vector Store. این عملیات‌ها خطای 404 unknown_url می‌گیرند. همان کار را با AI Agent و یک پایگاه برداری در خود n8n انجام دهید. فهرست کامل در endpointهایی که در گیسو نیستند آمده است.

خطاهای رایج

پرسش‌های پرتکرار

راهنماهای مرتبط