تحلیل ویدیو با Google Gemini AI: آپلود فرم و لینک یوتیوب

تحلیل ویدیو با Google Gemini AI: آپلود فرم و لینک‌های یوتیوب

این گردش کار از Google Gemini AI برای تجزیه و تحلیل محتوای ویدیو استفاده می‌کند و از آپلود مستقیم فایل از طریق فرم و همچنین تحلیل لینک‌های یوتیوب پشتیبانی می‌کند.

دسته‌بندی‌ها: تولید محتوا، هوش مصنوعی چندوجهی

کاتالوگ Axeto: https://axeto.ai/n8n

---

نمای کلی گردش کار

این گردش کار برای تجزیه و تحلیل محتوای ویدیو با استفاده از قابلیت‌های زبان مولد Google Gemini AI طراحی شده است. این گردش کار از دو روش ورودی اصلی پشتیبانی می‌کند:

• آپلود فرم: کاربران یک فایل ویدیویی را از طریق یک فرم وب آپلود می‌کنند. سپس این فایل برای تجزیه و تحلیل دقیق محتوا به API زبان مولد گوگل ارسال می‌شود.
• تجزیه و تحلیل لینک یوتیوب: کاربران می‌توانند یک URL ویدیوی یوتیوب را برای دریافت خلاصه‌ای مختصر از محتوای آن ارائه دهند.

گردش کار از نظر منطقی به بلوک‌های زیر تقسیم می‌شود:

1. دریافت ورودی: ورودی کاربر را از طریق ارسال فرم یا یک تریگر دستی برای آزمایش با لینک یوتیوب دریافت می‌کند.

2. آپلود و پردازش فایل: آپلود فایل‌های ویدیویی را به API Google Gemini AI مدیریت می‌کند.

3. انتظار و بازیابی تحلیل: تاخیرهایی را برای پردازش پیاده‌سازی می‌کند و سپس نتایج تحلیل را از هوش مصنوعی درخواست می‌کند.

4. تجزیه و تحلیل لینک یوتیوب: URLهای یوتیوب را برای دریافت خلاصه‌های ویدیو پردازش می‌کند.

5. استخراج و ارائه نتایج: متن تولید شده توسط هوش مصنوعی را برای هر دو مسیر تحلیل استخراج و قالب‌بندی می‌کند.

6. یادداشت‌های پیکربندی و راه‌اندازی: دستورالعمل‌ها و توضیحات ضروری برای راه‌اندازی و استفاده از گردش کار را ارائه می‌دهد.

---

تشریح گره‌ها (Nodes) به تفصیل

۱. دریافت ورودی

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

• گره (Node): On form submission

* نوع (Type): n8n-nodes-base.formTrigger

* نقش (Role): آپلود فایل‌های ویدئویی را از کاربران از طریق یک فرم وب با عنوان "Insert Video" دریافت می‌کند. این فرم شامل یک فیلد ورودی فایل اجباری با برچسب "Video" است.

* پیکربندی (Configuration): فقط از آپلود تک فایل پشتیبانی می‌کند.

* اتصالات (Connections): خروجی به گره Upload File می‌رود.

* نقاط شکست (Failure Points): خطاهای آپلود کاربر، مشکلات شبکه، فرمت‌های فایل پشتیبانی نشده (در صورت عدم فیلتر شدن در بالادست).

* نسخه (Version): ۲.۲

• گره (Node): When clicking ‘Test workflow’

* نوع (Type): n8n-nodes-base.manualTrigger (به طور پیش‌فرض غیرفعال است)

* نقش (Role): امکان فعال‌سازی دستی برای تست مسیر تحلیل ویدیوی یوتیوب را فراهم می‌کند.

* پیکربندی (Configuration): پارامتری ندارد.

* اتصالات (Connections): خروجی به گره YouTube Video می‌رود.

* نقاط شکست (Failure Points): فراموش کردن فعال‌سازی گره توسط کاربر.

* نسخه (Version): ۱

۲. آپلود و پردازش فایل

این بخش آپلود فایل ویدئویی کاربر را به نقطه پایانی آپلود فایل API گوگل جمینای مدیریت می‌کند.

• گره (Node): Upload File

* نوع (Type): n8n-nodes-base.httpRequest

* نقش (Role): داده‌های باینری ویدئو را به نقطه پایانی آپلود API زبان مولد گوگل آپلود می‌کند.

* پیکربندی (Configuration):

* URL: https://generativelanguage.googleapis.com/upload/v1beta/files

* متد (Method): POST

* Content-Type: داده‌های باینری با نوع MIME پویا که از نوع و پسوند فایل آپلود شده مشتق شده است.

* هدرها (Headers): شامل دستورات آپلود مخصوص گوگل (start, upload, finalize) و طول/نوع محتوا.

* احراز هویت (Authentication): احراز هویت کوئری HTTP عمومی با استفاده از اعتبارنامه کلید API گوگل.

* ورودی (Input): داده‌های فایل باینری از آپلود فرم، که معمولاً در $binary.Video ذخیره می‌شود.

* خروجی (Output): داده‌ها را به گره Wait منتقل می‌کند.

* نقاط شکست (Failure Points): مشکلات شبکه/زمان‌بندی، اعتبارنامه‌های نامعتبر یا گمشده، تجاوز از محدودیت‌های حجم فایل، نوع MIME نادرست، وقفه در آپلود.

* نسخه (Version): ۴.۲

۳. انتظار و بازیابی تحلیل

این بخش تاخیرهایی را برای اطمینان از پردازش فایل آپلود شده معرفی می‌کند و سپس درخواست تحلیل محتوای دقیق را از گوگل جمینای می‌کند.

• گره (Node): Wait

* نوع (Type): n8n-nodes-base.wait

* نقش (Role): پس از آپلود فایل، گردش کار را متوقف می‌کند تا زمان کافی برای پردازش قبل از درخواست تحلیل فراهم شود.

* پیکربندی (Configuration): تنظیمات پیش‌فرض انتظار، هیچ پارامتر صریحی تنظیم نشده است.

* ورودی (Input): داده‌ها را از گره Upload File دریافت می‌کند.

* خروجی (Output): داده‌ها را به گره Get Analysis منتقل می‌کند.

* نقاط شکست (Failure Points): ممکن است گردش کار در صورتی که مدت زمان انتظار ناکافی یا بیش از حد طولانی باشد، متوقف شود.

* نسخه (Version): ۱.۱

• گره (Node): 5 seconds

* نوع (Type): n8n-nodes-base.wait

* نقش (Role): یک تاخیر کوتاه اضافی (۵ ثانیه) پس از درخواست تحلیل ارائه می‌دهد. این می‌تواند به مدیریت زمان‌بندی یا تسهیل تلاش‌های مجدد کمک کند.

* پیکربندی (Configuration): مدت زمان انتظار روی ۵ ثانیه تنظیم شده است.

* ورودی (Input): داده‌ها را از خروجی ثانویه گره Get Analysis دریافت می‌کند.

* خروجی (Output): به گره Get Analysis بازمی‌گردد و مکانیزم‌های تلاش مجدد را فعال می‌کند.

* نقاط شکست (Failure Points): در صورت عدم پیکربندی بهینه، احتمال تاخیرهای غیرضروری وجود دارد.

* نسخه (Version): ۱.۱

• گره (Node): Get Analysis

* نوع (Type): n8n-nodes-base.httpRequest

* نقش (Role): یک درخواست POST به گوگل جمینای ارسال می‌کند تا توضیحات دقیقی از محتوای ویدئو تولید کند.

* پیکربندی (Configuration):

* URL: https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent

* متد (Method): POST

* بدنه (Body) (JSON): شامل fileUri و mimeType از پاسخ فایل آپلود شده است. حاوی یک پرامپت برای درخواست توضیحات دقیق ویدئو است.

* احراز هویت (Authentication): احراز هویت کوئری HTTP عمومی با استفاده از کلید API گوگل.

* مدیریت خطا (Error Handling): پیکربندی شده است تا حتی در صورت وقوع خطا، گردش کار را ادامه دهد و جزئیات خطا را خروجی دهد.

* ورودی (Input): فراداده فایل را از گره Wait قبلی دریافت می‌کند.

* خروجی (Output): نتایج تحلیل را به گره Video Analysis منتقل می‌کند و گره 5 seconds را برای تلاش‌های مجدد احتمالی فعال می‌کند.

* نقاط شکست (Failure Points): سهمیه API منقضی شده، اعتبارنامه‌های نامعتبر، درخواست نامفهوم، زمان‌بندی‌ها، فایل در URI یافت نشد، خطاهای عبارت JSON.

* نسخه (Version): ۴.۲

۴. تحلیل لینک یوتیوب

این بخش تحلیل URLهای ویدیوی یوتیوب ارائه شده از طریق تریگر دستی را مدیریت می‌کند و خلاصه‌ای از توضیحات را از گوگل جمینای درخواست می‌کند.

• گره (Node): YouTube Video

* نوع (Type): n8n-nodes-base.httpRequest

* نقش (Role): یک درخواست POST به گوگل جمینای ارسال می‌کند تا خلاصه‌ای از یک ویدیوی یوتیوب را بر اساس URL عمومی آن تولید کند.

* پیکربندی (Configuration):

* URL: https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent

* متد (Method): POST

* بدنه (Body) (JSON): شامل یک پرامپت برای خلاصه کردن ویدئو در سه جمله است. file_uri روی یک URL یوتیوب ثابت تنظیم شده است: https://youtu.be/gwCQF--cARA?si=uCbaUnoRlEjHO50a.

* احراز هویت (Authentication): احراز هویت کوئری HTTP عمومی با استفاده از کلید API گوگل.

* ورودی (Input): داده‌ها را از گره When clicking ‘Test workflow’ دریافت می‌کند.

* خروجی (Output): پاسخ هوش مصنوعی را به گره Get Results منتقل می‌کند.

* نقاط شکست (Failure Points): URL یوتیوب نامعتبر یا در دسترس نیست، خطاهای API، سهمیه منقضی شده، درخواست‌های نامفهوم.

* نسخه (Version): ۴.۲

• گره (Node): Get Results

* نوع (Type): n8n-nodes-base.set

* نقش (Role): متن خلاصه‌شده را از پاسخ هوش مصنوعی استخراج کرده و برای استفاده بعدی به یک فیلد text اختصاص می‌دهد.

* پیکربندی (Configuration): مقدار اولین متن محتوای کاندید از JSON پاسخ هوش مصنوعی را به فیلد text اختصاص می‌دهد.

* ورودی (Input): داده‌ها را از گره YouTube Video دریافت می‌کند.

* خروجی (Output): این معمولاً آخرین مرحله برای مسیر تحلیل یوتیوب است.

* نقاط شکست (Failure Points): JSON پاسخ گمشده یا نامفهوم، لیست کاندید خالی.

* نسخه (Version): ۳.۴

۵. استخراج و ارائه نتایج

این بخش متن تحلیل دقیق ویدئو تولید شده توسط هوش مصنوعی پس از تحلیل آپلود فایل را پردازش و ذخیره می‌کند.

• گره (Node): Video Analysis

* نوع (Type): n8n-nodes-base.set

* نقش (Role): توضیحات دقیق ویدئو را از پاسخ هوش مصنوعی استخراج کرده و در یک فیلد رشته‌ای Video Analysis ذخیره می‌کند.

* پیکربندی (Configuration): مقدار اولین بخش محتوای کاندید از JSON پاسخ هوش مصنوعی را به فیلد Video Analysis اختصاص می‌دهد.

* ورودی (Input): داده‌ها را از گره Get Analysis دریافت می‌کند.

* خروجی (Output): این معمولاً آخرین مرحله برای مسیر تحلیل آپلود فایل است.

* نقاط شکست (Failure Points): پاسخ هوش مصنوعی خالی یا نامفهوم، بخش‌های محتوای گمشده.

* نسخه (Version): ۳.۴

۶. یادداشت‌های پیکربندی و راه‌اندازی

این بخش شامل یادداشت‌های چسبان آموزشی برای راهنمایی کاربران در طول راه‌اندازی و درک گردش کار است.

• گره (Node): Sticky Note

* نقش (Role): بلوک "Form Trigger" را برای وضوح برچسب‌گذاری می‌کند.

* محتوا (Content): ## Form Trigger

• گره (Node): Sticky Note1

* نقش (Role): بلوک "Upload File" را برچسب‌گذاری می‌کند.

* محتوا (Content): ## Upload File

• گره (Node): Sticky Note2

* نقش (Role): بلوک "Get Analysis" را برچسب‌گذاری می‌کند.

* محتوا (Content): ## Get Analysis

• گره (Node): Sticky Note5

* نقش (Role): بلوک "Result" را برچسب‌گذاری می‌کند.

* محتوا (Content): ## Result

• گره (Node): Sticky Note7

* نقش (Role): بلوک "YouTube Vision" را برچسب‌گذاری می‌کند.

* محتوا (Content): # YouTube Vision

• گره (Node): Sticky Note8

* نقش (Role): یک راهنمای راه‌اندازی دقیق برای کاربران ارائه می‌دهد.

* محتوا (Content):

```markdown

# 🛠️ راهنمای راه‌اندازی

نویسنده: [Lee Wei]

### ✅ مرحله ۱: کلید API رایگان خود را دریافت کنید

به <strong>Google AI Studio</strong> بروید و ثبت نام کنید تا کلید API رایگان خود را دریافت کنید.

با استفاده از این کلید API، اعتبارنامه احراز هویت کوئری خود را در گره‌های HTTP Request که به احراز هویت گوگل نیاز دارند، ایجاد کنید.

### 🎬 مرحله ۲: ورودی ویدئو را ارائه دهید

اکنون آماده استفاده از گردش کار هستید:

- یک ویدئو را با استفاده از Form Trigger آپلود کنید، یا

- گردش کار را به صورت دستی برای تحلیل یک URL یوتیوب فعال کنید.

---

ایجنت تحلیل ویدیوی شما اکنون عملیاتی است.

```

* نقاط شکست (Failure Points): ندارد، زیرا اینها گره‌های صرفاً اطلاعاتی هستند.

---

جدول خلاصه