n8n-nodes-autoverse-multimodal

Node مجتمعي واحد لـ n8n يجمع كل قدرات OpenRouter متعددة الوسائط في مكان واحد:
محادثة نصية، تحليل صور، تحليل صوت، تحويل الصوت إلى نص (STT)،
تحليل مستندات/PDF، وتحليل فيديو، مع اكتشاف ديناميكي لقدرات النماذج من
نقطة /api/v1/models.

✨ المميّزات

• عملية واحدة، ستّ إمكانيات (Operations):

  • Chat Completion (Text)
  • Image Analysis (Vision) — عبر type: "image_url"
  • Audio Analysis — عبر type: "input_audio"
  • Speech to Text (Transcription) — عبر /audio/transcriptions
  • Document / PDF Analysis — عبر type: "file" + Plugin file-parser
  • Video Analysis — عبر type: "video_url"

• قائمة نماذج ديناميكية: تُملأ من /api/v1/models مع فلترة حسب
  input_modalities / output_modalities المطلوبة للعملية المختارة.

• تحقّق تلقائي من التوافق: قبل الإرسال، يتحقق الـ Node أن النموذج
  يدعم نوع الدخل المطلوب ويعرض رسالة عربية واضحة إن لم يكن كذلك.

• دعم ثلاث طرق لإدخال الوسائط:

  1. Binary Property من العنصر الوارد (يُحوَّل تلقائيًا إلى Base64).
  2. Public URL (رابط مباشر HTTPS).
  3. Raw Base64 (مع أو بدون بادئة data:).

• استنتاج تلقائي لـ MIME من الـ Binary أو امتداد الرابط، مع
  إمكانية التجاوز اليدوي.

• إعدادات متقدمة: Provider Routing (order/fallbacks/data_collection)،
  Response Format (json_object)، Temperature/Max Tokens/Top P،
  و Extra Body (JSON خام يُدمج مع الطلب).

• مخرجات موحّدة:

  {
    "operation": "imageAnalysis",
    "model": "google/gemini-2.5-flash",
    "text": "…",
    "usage": { "total_tokens": 512, "cost": 0.0004 },
    "cost": 0.0004,
    "raw": { … }
  }
  

🛠️ التثبيت

الطريقة 1 — كحزمة مجتمعية داخل n8n

1. افتح Settings → Community Nodes → Install.
2. أدخل اسم الحزمة: n8n-nodes-autoverse-multimodal.
3. اضغط Install (يشترط أن يكون Community Nodes مُفعّلًا في إعدادات n8n
   بالمتغير N8N_COMMUNITY_PACKAGES_ENABLED=true).

الطريقة 2 — تثبيت محلي من الملف المضغوط

# فك ضغط الملف المرفق
unzip n8n-nodes-autoverse-multimodal.zip
cd n8n-nodes-autoverse-multimodal

# تثبيت التبعيات ثم البناء
npm install
npm run build

# ربطه بمثيل n8n المحلي
npm link
cd ~/.n8n/custom   # أنشئها إن لم توجد
npm link n8n-nodes-autoverse-multimodal

# أعد تشغيل n8n
n8n start

الطريقة 3 — نسخ dist مباشرة

انسخ محتوى مجلد dist/ إلى ~/.n8n/custom/n8n-nodes-autoverse-multimodal/
وتأكد أن package.json موجود في نفس المجلد، ثم أعد تشغيل n8n.

🔑 إعداد الاعتمادات

عند إضافة الـ Node لأول مرة، أنشئ اعتماد AutoVerse Multimodal API جديدًا:

يقوم n8n تلقائيًا باختبار الاعتماد بمناداة GET /models.

🚀 استخدام سريع

مثال 1 — تحليل صورة (Vision)

1. اسحب Node AutoVerse Multimodal إلى الـ workflow.
2. اختر:
   • Operation: Image Analysis (Vision)
   • Model: (اختر من القائمة — مثلاً google/gemini-2.5-flash).
   • Input Source: Binary Data From Previous Node
   • Binary Property: data (اسم خاصية الصورة).
   • User Prompt: صف محتوى هذه الصورة بالتفصيل.
3. نفّذ. ستحصل على:

   {
     "operation": "imageAnalysis",
     "model": "google/gemini-2.5-flash",
     "text": "الصورة تُظهر …",
     "usage": { … },
     "cost": 0.00023
   }
   

مثال 2 — تحويل صوت إلى نص (STT)

• Operation: Speech to Text (Transcription)
• Model: openai/whisper-1 أو أي نموذج مُصفَّى تلقائيًا.
• Input Source: Binary واختر data (ملف mp3/wav).
• Language: ar (اختياري).
• Response Format: verbose_json (مع segments) أو text.

مثال 3 — تحليل PDF

• Operation: Document / PDF Analysis
• Model: أي نموذج نصي (سيمرَّر عبر Plugin file-parser).
• PDF Engine: pdf-text (مجاني) أو mistral-ocr أو native.
• User Prompt: لخّص أهم النقاط في هذا التقرير.

مثال 4 — تحليل فيديو

• Operation: Video Analysis
• Model: نموذج يدعم مدخلات فيديو (يُصفَّى تلقائيًا).
• Input Source: Public URL (مثال: رابط YouTube لنموذج Gemini).

📚 مرجع الحقول

🧪 قائمة اختبارات موصى بها

1. GET /models بدون فلاتر → التأكد من صحة الاعتماد.
2. تحليل صورة كـ Binary + كـ URL → مقارنة الاستجابتين.
3. تحويل صوت < 25MB إلى نص (Whisper) بلغة ar.
4. تحليل PDF رقمي عبر pdf-text ثم عبر mistral-ocr.
5. تحليل فيديو YouTube عبر Gemini.
6. اختبار خطأ التوافق: أرسل صورة لنموذج openai/gpt-4 → يجب أن يمنعه الـ Node مسبقًا.

⚠️ ملاحظات وقيود

• ملفات الصوت > 25 MB يُنصح بتقسيمها أو استخدام JSON مع Base64 بدلًا من multipart.
• دعم الفيديو يختلف حسب الموفّر: Gemini على AI Studio يدعم روابط YouTube فقط.
• التكلفة تظهر في حقل usage.cost (بالدولار الأمريكي) في كل استجابة.
• لا يُخزَّن مفتاح API إلا في نظام الاعتمادات المشفّر داخل n8n.

🧑‍💻 التطوير

npm install
npm run dev    # يراقب التغييرات
npm run build  # بناء إنتاج (dist/)
npm run lint   # فحص TypeScript فقط

بنية المشروع:

n8n-nodes-autoverse-multimodal/
├── credentials/
│   └── OpenRouterApi.credentials.ts
├── nodes/
│   └── OpenRouterMultimodal/
│       ├── OpenRouterMultimodal.node.ts
│       └── openrouter.svg
├── build-icons.js
├── index.js
├── package.json
├── tsconfig.json
└── README.md

الترخيص

MIT © 2026