مستندات n8n
74+ نود
🤖

اوپن‌ای‌آی

OpenAI

هوش مصنوعی GPT-4o، تولید تصویر DALL-E 3، گفتار به متن Whisper

هوش مصنوعی
متوسط
۰ بازدید
n8n 1.0+

نمای کلی

نود OpenAI یکی از هیجان‌انگیزترین نودهای n8n است که قدرت هوش مصنوعی را به workflowهای شما اضافه می‌کند.

قابلیت‌های کلیدی:

  • چت با GPT-4o، GPT-4 و GPT-3.5
  • تولید تصویر با DALL-E 3
  • تبدیل گفتار به متن با Whisper
  • تبدیل متن به گفتار (TTS)
  • Embeddings برای جستجوی معنایی
  • تحلیل تصویر (Vision)
  • Function Calling
  • JSON Mode (خروجی ساختاریافته)

مدل‌های موجود:

  • GPT-4o: سریع‌ترین و بهترین مدل (متن + تصویر)
  • GPT-4o-mini: ارزان و سریع برای کارهای ساده
  • GPT-4 Turbo: قدرتمند با context بلند (128K)
  • GPT-3.5 Turbo: ارزان برای کارهای عمومی
  • DALL-E 3: تولید تصویر باکیفیت
  • Whisper: تبدیل صدا به متن (پشتیبانی از فارسی)
  • TTS-1/TTS-1-HD: متن به گفتار

کاربردها:

  • چت‌بات پشتیبانی هوشمند
  • تولید محتوای وبلاگ و شبکه‌های اجتماعی
  • ترجمه خودکار
  • خلاصه‌سازی متن و ایمیل
  • تحلیل احساسات نظرات مشتریان
  • پاسخ خودکار به ایمیل
  • تولید کد و اسکریپت
  • طبقه‌بندی و دسته‌بندی خودکار

احراز هویت

احراز هویت OpenAI

دریافت API Key:

  1. 1به [platform.openai.com](https://platform.openai.com) بروید
  2. 2ثبت‌نام یا ورود کنید
  3. 3به API Keys بروید
  4. 4Create new secret key کلیک کنید
  5. 5نام دلخواه بگذارید (مثل "n8n-automation")
  6. 6کلید تولید شده را فوراً کپی کنید (فقط یک بار نمایش داده می‌شود)

تنظیم در n8n:

  1. 1Credentials > OpenAI API
  2. 2API Key وارد کنید
  3. 3Organization ID (اختیاری): اگر چند سازمان دارید
  4. 4Test Connection بزنید

شارژ اکانت:

  1. 1به Billing > Payment methods بروید
  2. 2کارت بانکی اضافه کنید
  3. 3Add to credit balance بزنید
  4. 4حداقل 5 دلار شارژ کنید

تنظیم محدودیت هزینه:

  1. 1Billing > Usage limits
  2. 2Hard limit: حداکثر هزینه ماهانه
  3. 3Soft limit: هشدار ایمیلی

قیمت‌های تقریبی (هر 1 میلیون توکن):

code
GPT-4o:        $2.50 ورودی / $10 خروجی
GPT-4o-mini:   $0.15 ورودی / $0.60 خروجی
GPT-4 Turbo:   $10 ورودی / $30 خروجی
GPT-3.5:       $0.50 ورودی / $1.50 خروجی
DALL-E 3:      $0.04 - $0.12 per image
Whisper:       $0.006 per minute
TTS:           $15 per 1M characters

نکات مهم:

  • API Key را در جای امن نگه دارید
  • از Organization ID برای مدیریت بهتر استفاده کنید
  • Usage Limits تنظیم کنید تا هزینه کنترل شود
  • Rate Limits: بسته به سطح اکانت متفاوت است

عملیات‌های موجود

1

chatCompletion

مکالمه با مدل‌های GPT-4o، GPT-4، GPT-3.5

2

imageGeneration

ایجاد تصویر از توصیف متنی

3

audioTranscription

تبدیل فایل صوتی به متن

4

textToSpeech

تبدیل متن به فایل صوتی

5

embedding

تبدیل متن به بردار عددی برای جستجوی معنایی

6

vision

تحلیل و توصیف تصویر با GPT-4o

کاربردهای متداول

1. چت‌بات پشتیبانی هوشمند

پاسخ به سوالات مشتریان:

code
Telegram Trigger (پیام کاربر)
  → OpenAI (Chat)
    Model: gpt-4o-mini
    System: "تو یک پشتیبان فارسی‌زبان فروشگاه آنلاین هستی.
    فقط به سوالات مربوط به محصولات و سفارشات پاسخ بده.
    اگر سوال فنی بود، به تیم پشتیبانی ارجاع بده."
    User: {{$json.message}}
    Temperature: 0.3
  → Telegram (ارسال پاسخ)

2. خلاصه‌سازی ایمیل

خلاصه ایمیل‌های بلند:

code
Gmail (Get All - unread)
  → OpenAI (Chat)
    System: "ایمیل زیر را در 2-3 جمله فارسی خلاصه کن.
    اگر اقدامی نیاز است، مشخص کن."
    User: {{$json.body}}
    Temperature: 0.2
    MaxTokens: 200
  → Telegram (ارسال خلاصه)

3. تحلیل احساسات نظرات

دسته‌بندی نظرات مشتریان:

code
MySQL (نظرات جدید)
  → OpenAI (Chat)
    System: "نظر زیر را تحلیل کن. فقط JSON برگردان:
    {sentiment: positive/negative/neutral, topics: [...], score: 1-5}"
    User: {{$json.comment}}
    ResponseFormat: json_object
    Temperature: 0
  → Set (Parse JSON)
  → MySQL (ذخیره نتیجه)

4. ترجمه خودکار

ترجمه محتوا:

code
Webhook (متن جدید)
  → OpenAI (Chat)
    System: "متن فارسی زیر را به انگلیسی روان ترجمه کن.
    لحن رسمی و حرفه‌ای داشته باش."
    User: {{$json.text}}
    Temperature: 0.3
  → MySQL (ذخیره ترجمه)

5. تولید محتوای شبکه‌های اجتماعی

تولید پست اینستاگرام:

code
Schedule (هر روز ساعت 10)
  → MySQL (محصول روز)
  → OpenAI (Chat)
    System: "یک کپشن فارسی جذاب برای اینستاگرام بنویس.
    شامل: توصیف محصول، مزایا، قیمت، هشتگ‌ها.
    لحن: دوستانه و حرفه‌ای. حداکثر 300 کلمه."
    User: محصول: {{$json.name}}
    قیمت: {{$json.price}} تومان
    ویژگی‌ها: {{$json.features}}
  → Telegram (ارسال برای تایید ادمین)

6. تولید تصویر محصول

ساخت تصویر با DALL-E:

code
Webhook (درخواست تصویر)
  → OpenAI (Image Generation)
    Model: dall-e-3
    Prompt: "Professional product photo of {{$json.product}},
    clean white background, studio lighting, 4K quality"
    Size: 1024x1024
    Quality: hd
  → Google Drive (آپلود تصویر)

7. تبدیل صدا به متن

رونویسی جلسات:

code
Webhook (فایل صوتی)
  → OpenAI (Whisper)
    Language: fa
    Prompt: "جلسه تیم فنی درباره محصول جدید"
  → OpenAI (Chat)
    System: "متن جلسه زیر را خلاصه کن:
    1. موضوعات مطرح شده
    2. تصمیمات گرفته شده
    3. اقدامات بعدی"
    User: {{$json.text}}
  → Google Drive (ذخیره خلاصه)

8. طبقه‌بندی تیکت‌ها

دسته‌بندی خودکار تیکت‌های پشتیبانی:

code
Webhook (تیکت جدید)
  → OpenAI (Chat)
    System: "تیکت زیر را بررسی کن. JSON برگردان:
    {
      department: فنی/مالی/فروش/عمومی,
      priority: low/medium/high/critical,
      summary: خلاصه 1 جمله‌ای,
      suggestedResponse: پیشنهاد پاسخ
    }"
    ResponseFormat: json_object
    Temperature: 0
  → MySQL (ذخیره دسته‌بندی)
  → IF (priority = critical)
    → Telegram (هشدار فوری)

9. بررسی SEO محتوا

تحلیل و بهبود محتوای وب:

code
Webhook (محتوای جدید)
  → OpenAI (Chat)
    System: "محتوای زیر را از نظر SEO بررسی کن:
    1. عنوان‌ها
    2. کلمات کلیدی
    3. طول محتوا
    4. پیشنهاد بهبود
    به فارسی پاسخ بده."
    Temperature: 0.3
  → Gmail (ارسال گزارش SEO)

10. پاسخ خودکار به ایمیل

پیش‌نویس پاسخ ایمیل:

code
Gmail Trigger (ایمیل جدید)
  → OpenAI (Chat)
    System: "یک پاسخ حرفه‌ای فارسی به این ایمیل بنویس.
    لحن: رسمی و مودبانه.
    اگر اطلاعات کافی نداری، بخواه توضیح بیشتر بدن."
    User: "فرستنده: {{$json.from}}
    موضوع: {{$json.subject}}
    متن: {{$json.body}}"
    Temperature: 0.5
  → Gmail (ذخیره Draft)

نکات حرفه‌ای

نکات حرفه‌ای

  1. 1System Message مؤثر: بهترین نتایج با prompt دقیق:
code
// بد:
   "به سوالات پاسخ بده"

   // خوب:
   "تو یک متخصص پشتیبانی فروشگاه الکترونیک هستی.
   - فقط به فارسی پاسخ بده
   - پاسخ‌ها کوتاه و مفید باشند (حداکثر 100 کلمه)
   - اگر سوال خارج از حوزه بود، بگو نمی‌دانی
   - لحن: دوستانه و حرفه‌ای
   - قیمت‌ها به تومان باشند"
  1. 1Temperature Guide:
code
0.0: پاسخ دقیق و یکسان (طبقه‌بندی، استخراج داده)
   0.3: پاسخ دقیق با کمی تنوع (ترجمه، خلاصه)
   0.7: پاسخ خلاقانه (تولید محتوا)
   1.0: پاسخ بسیار خلاقانه (داستان، شعر)
  1. 1JSON Mode: خروجی ساختاریافته:
code
Response Format: json_object
   System: "خروجی را فقط JSON برگردان:
   {name: string, category: string, score: number}"
  1. 1Token Management: کنترل هزینه:
code
// هر کلمه فارسی ≈ 3-5 توکن
   // هر کلمه انگلیسی ≈ 1-2 توکن
   // 1000 توکن ≈ 200 کلمه فارسی

   MaxTokens: 500  // محدود کردن پاسخ
  1. 1Few-shot Learning: آموزش با مثال:
code
System: "نظرات را تحلیل کن.
   مثال 1: 'محصول عالی بود' → positive
   مثال 2: 'تحویل دیر شد' → negative
   مثال 3: 'معمولی بود' → neutral"
  1. 1Conversation History: حافظه مکالمه:
code
Messages: [
     {role: "system", content: "..."},
     {role: "user", content: "سلام"},
     {role: "assistant", content: "سلام! چطور می‌تونم کمکتون کنم؟"},
     {role: "user", content: "{{$json.newMessage}}"}
   ]
  1. 1مدل مناسب انتخاب کنید:
code
کار ساده (طبقه‌بندی، خلاصه): gpt-4o-mini
   کار پیچیده (تحلیل، کد): gpt-4o
   تصویر: dall-e-3
   صدا: whisper-1
  1. 1Streaming: برای چت‌بات Real-time از Streaming استفاده کنید.
  1. 1Content Filtering: OpenAI محتوای نامناسب را فیلتر می‌کند. در System Message بنویسید:
code
"اگر سوال نامناسب بود، مودبانه بگو نمی‌توانی پاسخ بدهی."
  1. 1Retry on Error: برای Rate Limit:
code
OpenAI → Error → Wait (5 seconds) → OpenAI (Retry)
  1. 1Caching: پاسخ‌های تکراری را کش کنید:
code
Webhook → MongoDB (Check Cache)
      → IF (Cache hit) → Return cached
      → IF (Cache miss) → OpenAI → MongoDB (Save) → Return
  1. 1بهینه‌سازی Prompt فارسی:
code
// نکته: GPT فارسی را خوب می‌فهمد
    // ولی Prompt انگلیسی دقت بیشتری دارد
    // راه‌حل: System Message انگلیسی + User Message فارسی

    System: "You are a customer support assistant.
    Always respond in Persian (Farsi).
    Be polite and professional."
    User: "سفارش من کجاست؟"
  1. 1Function Calling: ارتباط AI با ابزارها:
code
// AI تصمیم می‌گیرد کدام تابع فراخوانی شود
    Functions: [
      {name: "getOrder", description: "وضعیت سفارش"},
      {name: "createTicket", description: "ثبت تیکت"}
    ]
  1. 1Vision (تحلیل تصویر):
code
// بررسی عکس رسید پرداخت
    System: "عکس رسید بانکی را بررسی کن. JSON برگردان:
    {amount, date, trackingCode, bankName}"
    Image: URL رسید
  1. 1مدیریت هزینه:
  • از gpt-4o-mini برای کارهای ساده استفاده کنید (10x ارزان‌تر)
  • MaxTokens محدود کنید
  • Cache پاسخ‌های تکراری
  • Usage Dashboard مانیتور کنید

رفع مشکلات

خطاهای رایج

1. خطای "Incorrect API key" (401)

علت: API Key اشتباه یا غیرفعال

راه‌حل

  • API Key را از platform.openai.com چک کنید
  • کلید جدید بسازید اگر لازم است
  • مطمئن شوید کلید کامل کپی شده (شروع با sk-)

2. خطای "Insufficient quota" (429)

علت: اعتبار تمام شده

راه‌حل

  • Billing > Overview: مانده اعتبار را بررسی کنید
  • اعتبار شارژ کنید ($5 حداقل)
  • Usage Limits بررسی کنید
  • اگر Free Tier: باید شارژ کنید

3. خطای "Rate limit reached"

علت: تعداد درخواست بیش از حد مجاز

راه‌حل

  • بین درخواست‌ها Wait اضافه کنید
  • از مدل ارزان‌تر استفاده کنید (gpt-4o-mini)
  • Batch Size کاهش دهید
  • Rate Limits:
  • Tier 1: 500 RPM / 30,000 TPM
  • Tier 2: 5,000 RPM / 450,000 TPM

4. خطای "Context length exceeded"

علت: متن ورودی خیلی بلند

راه‌حل

  • متن را خلاصه یا برش بزنید
  • از مدل با context بیشتر استفاده کنید:
  • GPT-4o: 128K tokens
  • GPT-3.5: 16K tokens
  • محتوا را تکه‌تکه ارسال کنید

5. پاسخ نامربوط

علت: System Message ضعیف

راه‌حل

  • System Message دقیق‌تر بنویسید
  • Temperature کاهش دهید (0.2-0.3)
  • مثال‌هایی در System Message اضافه کنید
  • از JSON Mode استفاده کنید

6. خطای "Invalid image"

علت: فرمت تصویر پشتیبانی نمی‌شود

راه‌حل

  • فرمت‌های مجاز: PNG, JPEG, GIF, WEBP
  • حداکثر حجم: 20MB
  • URL تصویر باید عمومی باشد

7. Whisper دقیق نیست

علت: کیفیت صدا پایین

راه‌حل

  • زبان را مشخص کنید: language: 'fa'
  • Prompt راهنما اضافه کنید
  • فرمت‌های بهتر: mp3, wav
  • نویز پس‌زمینه کاهش دهید
اشتراک‌گذاری:

آیا این مستندات مفید بود؟