# GeminiNodeV3

با مدل‌های Gemini گوگل پاسخ‌های متنی تولید کنید. یک پرامپت متنی و به‌صورت اختیاری یک یا چند تصویر، کلیپ صوتی، ویدیو یا فایل را به‌عنوان زمینه چندوجهی ارائه دهید. مدل انتخاب‌شده تعیین می‌کند که کدام تنظیمات اضافی نمایش داده شوند.

## ورودی‌ها

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `model` | مدل Gemini استفاده‌شده برای تولید پاسخ. مدل انتخاب‌شده تعیین می‌کند که کدام ورودی‌های اضافی نمایش داده شوند. | DYNAMIC_COMBO | بله | `"Gemini 3.8 Flash"`<br>`"Gemini 3.7 Flash"`<br>`"Gemini 3.5 Flash"`<br>`"Gemini 3.1 Pro"`<br>`"Gemini 3.1 Flash-Lite"` |

### ورودی‌های رسانه‌ای

این ورودی‌های رسانه‌ای قابل‌افزایش برای همه گزینه‌های مدل در دسترس هستند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `images` | تصویر(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. حداکثر 16 تصویر. اسلات قابل‌افزایش: تصاویر را به `image_1` تا `image_16` متصل کنید. | IMAGE | خیر | حداکثر 16 تصویر |
| `audio` | کلیپ صوتی اختیاری برای استفاده به‌عنوان زمینه برای مدل. اسلات قابل‌افزایش: `audio_1`. | AUDIO | خیر | 1 کلیپ صوتی |
| `video` | کلیپ ویدیویی اختیاری برای استفاده به‌عنوان زمینه برای مدل. اسلات قابل‌افزایش: `video_1`. | VIDEO | خیر | 1 کلیپ ویدیویی |

### ورودی‌های Gemini 3.8 Flash

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | ورودی متنی به مدل. شامل دستورالعمل‌های دقیق، پرسش‌ها یا زمینه باشد. نباید خالی باشد. | STRING | بله | متن چندخطی (باید حداقل شامل یک کاراکتر غیر از فاصله باشد) |
| `video_processing` | نحوه خواندن ویدیوی پیوست‌شده توسط مدل. حالت `static` فریم‌ها را با نرخ ثابت نمونه‌برداری می‌کند و همه آن‌ها را به‌عنوان زمینه می‌فرستد؛ حالت `agentic` به مدل اجازه می‌دهد خودش خط زمانی را پیمایش کند و فقط فریم‌ها، صدا یا رونوشتی را که نیاز دارد بارگذاری کند، که برای ویدیوهای طولانی توکن‌های ورودی بسیار کمتری مصرف می‌کند. | COMBO | بله | `"static"`<br>`"agentic"` (پیش‌فرض: `"static"`) |
| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی از گره Gemini Input Files می‌پذیرد. | GEMINI_INPUT_FILES | خیر | N/A |
| `thinking_level` | میزان تلاش مدل برای استدلال داخلی پیش از پاسخ‌دهی. مقدار HIGH کیفیت را در کارهای دشوار بهبود می‌دهد، اما توکن‌های (تفکر) بیشتری مصرف می‌کند و کندتر است. | COMBO | بله | `"LOW"`<br>`"MEDIUM"`<br>`"HIGH"` (پیش‌فرض: `"MEDIUM"`) |
| `max_output_tokens` | حداکثر توکن‌های قابل تولید، شامل تفکر داخلی مدل. با `thinking_level` روی HIGH، مقدار کم ممکن است فضایی برای پاسخ باقی نگذارد؛ اگر پاسخ‌ها خالی یا ناقص برگردند این مقدار را افزایش دهید. مدل پس از پایان کار زودتر متوقف می‌شود، بنابراین سقف بالاتر برای پاسخ‌های کوتاه هزینه اضافی ندارد. | INT | بله | 16-65536 (پیش‌فرض: 32768) |
| `seed` | بذر نمونه‌برداری. برای بذر تصادفی روی 0 تنظیم کنید. خروجی قطعی تضمین نمی‌شود. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `system_prompt` | دستورالعمل‌های پایه‌ای که رفتار مدل را تعیین می‌کنند. | STRING | بله | متن چندخطی (پیش‌فرض: خالی) |

### ورودی‌های Gemini 3.7 Flash

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | ورودی متنی به مدل. شامل دستورالعمل‌های دقیق، پرسش‌ها یا زمینه باشد. نباید خالی باشد. | STRING | بله | متن چندخطی (باید حداقل شامل یک کاراکتر غیر از فاصله باشد) |
| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی از گره Gemini Input Files می‌پذیرد. | GEMINI_INPUT_FILES | خیر | N/A |
| `thinking_level` | میزان تلاش مدل برای استدلال داخلی پیش از پاسخ‌دهی. مقدار HIGH کیفیت را در کارهای دشوار بهبود می‌دهد، اما توکن‌های (تفکر) بیشتری مصرف می‌کند و کندتر است. | COMBO | بله | `"LOW"`<br>`"MEDIUM"`<br>`"HIGH"` (پیش‌فرض: `"MEDIUM"`) |
| `temperature` | میزان تصادفی‌بودن را کنترل می‌کند. مقدار کمتر متمرکزتر/قطعی‌تر و مقدار بیشتر خلاقانه‌تر است. | FLOAT | بله | 0.0-2.0 (پیش‌فرض: 1.0) |
| `top_p` | نمونه‌برداری هسته‌ای: نمونه‌گیری از کوچک‌ترین مجموعه توکن‌ها که احتمال تجمعی آن به `top_p` می‌رسد. | FLOAT | بله | 0.0-1.0 (پیش‌فرض: 0.95) |
| `max_output_tokens` | حداکثر توکن‌های قابل تولید، شامل تفکر داخلی مدل. با `thinking_level` روی HIGH، مقدار کم ممکن است فضایی برای پاسخ باقی نگذارد؛ اگر پاسخ‌ها خالی یا ناقص برگردند این مقدار را افزایش دهید. مدل پس از پایان کار زودتر متوقف می‌شود، بنابراین سقف بالاتر برای پاسخ‌های کوتاه هزینه اضافی ندارد. | INT | بله | 16-65536 (پیش‌فرض: 32768) |
| `seed` | بذر نمونه‌برداری. برای بذر تصادفی روی 0 تنظیم کنید. خروجی قطعی تضمین نمی‌شود. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `system_prompt` | دستورالعمل‌های پایه‌ای که رفتار مدل را تعیین می‌کنند. | STRING | بله | متن چندخطی (پیش‌فرض: خالی) |

### ورودی‌های Gemini 3.5 Flash

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | ورودی متنی به مدل. شامل دستورالعمل‌های دقیق، پرسش‌ها یا زمینه باشد. نباید خالی باشد. | STRING | بله | متن چندخطی (باید حداقل شامل یک کاراکتر غیر از فاصله باشد) |
| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی از گره Gemini Input Files می‌پذیرد. | GEMINI_INPUT_FILES | خیر | N/A |
| `thinking_level` | میزان تلاش مدل برای استدلال داخلی پیش از پاسخ‌دهی. مقدار HIGH کیفیت را در کارهای دشوار بهبود می‌دهد، اما توکن‌های (تفکر) بیشتری مصرف می‌کند و کندتر است. | COMBO | بله | `"MINIMAL"`<br>`"LOW"`<br>`"MEDIUM"`<br>`"HIGH"` (پیش‌فرض: `"MEDIUM"`) |
| `temperature` | میزان تصادفی‌بودن را کنترل می‌کند. مقدار کمتر متمرکزتر/قطعی‌تر و مقدار بیشتر خلاقانه‌تر است. | FLOAT | بله | 0.0-2.0 (پیش‌فرض: 1.0) |
| `top_p` | نمونه‌برداری هسته‌ای: نمونه‌گیری از کوچک‌ترین مجموعه توکن‌ها که احتمال تجمعی آن به `top_p` می‌رسد. | FLOAT | بله | 0.0-1.0 (پیش‌فرض: 0.95) |
| `max_output_tokens` | حداکثر توکن‌های قابل تولید، شامل تفکر داخلی مدل. با `thinking_level` روی HIGH، مقدار کم ممکن است فضایی برای پاسخ باقی نگذارد؛ اگر پاسخ‌ها خالی یا ناقص برگردند این مقدار را افزایش دهید. مدل پس از پایان کار زودتر متوقف می‌شود، بنابراین سقف بالاتر برای پاسخ‌های کوتاه هزینه اضافی ندارد. | INT | بله | 16-65536 (پیش‌فرض: 32768) |
| `seed` | بذر نمونه‌برداری. برای بذر تصادفی روی 0 تنظیم کنید. خروجی قطعی تضمین نمی‌شود. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `system_prompt` | دستورالعمل‌های پایه‌ای که رفتار مدل را تعیین می‌کنند. | STRING | بله | متن چندخطی (پیش‌فرض: خالی) |

### ورودی‌های Gemini 3.1 Pro

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | ورودی متنی به مدل. شامل دستورالعمل‌های دقیق، پرسش‌ها یا زمینه باشد. نباید خالی باشد. | STRING | بله | متن چندخطی (باید حداقل شامل یک کاراکتر غیر از فاصله باشد) |
| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی از گره Gemini Input Files می‌پذیرد. | GEMINI_INPUT_FILES | خیر | N/A |
| `thinking_level` | میزان تلاش مدل برای استدلال داخلی پیش از پاسخ‌دهی. مقدار HIGH کیفیت را در کارهای دشوار بهبود می‌دهد، اما توکن‌های (تفکر) بیشتری مصرف می‌کند و کندتر است. | COMBO | بله | `"LOW"`<br>`"HIGH"` (پیش‌فرض: `"HIGH"`) |
| `temperature` | میزان تصادفی‌بودن را کنترل می‌کند. مقدار کمتر متمرکزتر/قطعی‌تر و مقدار بیشتر خلاقانه‌تر است. | FLOAT | بله | 0.0-2.0 (پیش‌فرض: 1.0) |
| `top_p` | نمونه‌برداری هسته‌ای: نمونه‌گیری از کوچک‌ترین مجموعه توکن‌ها که احتمال تجمعی آن به `top_p` می‌رسد. | FLOAT | بله | 0.0-1.0 (پیش‌فرض: 0.95) |
| `max_output_tokens` | حداکثر توکن‌های قابل تولید، شامل تفکر داخلی مدل. با `thinking_level` روی HIGH، مقدار کم ممکن است فضایی برای پاسخ باقی نگذارد؛ اگر پاسخ‌ها خالی یا ناقص برگردند این مقدار را افزایش دهید. مدل پس از پایان کار زودتر متوقف می‌شود، بنابراین سقف بالاتر برای پاسخ‌های کوتاه هزینه اضافی ندارد. | INT | بله | 16-65536 (پیش‌فرض: 32768) |
| `seed` | بذر نمونه‌برداری. برای بذر تصادفی روی 0 تنظیم کنید. خروجی قطعی تضمین نمی‌شود. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `system_prompt` | دستورالعمل‌های پایه‌ای که رفتار مدل را تعیین می‌کنند. | STRING | بله | متن چندخطی (پیش‌فرض: خالی) |

### ورودی‌های Gemini 3.1 Flash-Lite

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | ورودی متنی به مدل. شامل دستورالعمل‌های دقیق، پرسش‌ها یا زمینه باشد. نباید خالی باشد. | STRING | بله | متن چندخطی (باید حداقل شامل یک کاراکتر غیر از فاصله باشد) |
| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی از گره Gemini Input Files می‌پذیرد. | GEMINI_INPUT_FILES | خیر | N/A |
| `thinking_level` | میزان تلاش مدل برای استدلال داخلی پیش از پاسخ‌دهی. مقدار HIGH کیفیت را در کارهای دشوار بهبود می‌دهد، اما توکن‌های (تفکر) بیشتری مصرف می‌کند و کندتر است. | COMBO | بله | `"LOW"`<br>`"HIGH"` (پیش‌فرض: `"LOW"`) |
| `temperature` | میزان تصادفی‌بودن را کنترل می‌کند. مقدار کمتر متمرکزتر/قطعی‌تر و مقدار بیشتر خلاقانه‌تر است. | FLOAT | بله | 0.0-2.0 (پیش‌فرض: 1.0) |
| `top_p` | نمونه‌برداری هسته‌ای: نمونه‌گیری از کوچک‌ترین مجموعه توکن‌ها که احتمال تجمعی آن به `top_p` می‌رسد. | FLOAT | بله | 0.0-1.0 (پیش‌فرض: 0.95) |
| `max_output_tokens` | حداکثر توکن‌های قابل تولید، شامل تفکر داخلی مدل. با `thinking_level` روی HIGH، مقدار کم ممکن است فضایی برای پاسخ باقی نگذارد؛ اگر پاسخ‌ها خالی یا ناقص برگردند این مقدار را افزایش دهید. مدل پس از پایان کار زودتر متوقف می‌شود، بنابراین سقف بالاتر برای پاسخ‌های کوتاه هزینه اضافی ندارد. | INT | بله | 16-65536 (پیش‌فرض: 32768) |
| `seed` | بذر نمونه‌برداری. برای بذر تصادفی روی 0 تنظیم کنید. خروجی قطعی تضمین نمی‌شود. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `system_prompt` | دستورالعمل‌های پایه‌ای که رفتار مدل را تعیین می‌کنند. | STRING | بله | متن چندخطی (پیش‌فرض: خالی) |

توجه: برای Gemini 3.8 Flash، پارامترهای `temperature` و `top_p` در دسترس نیستند و `video_processing` فقط برای این گزینه مدل موجود است. گزینه‌ها و مقدار پیش‌فرض `thinking_level` بسته به مدل، مطابق فهرست بالا، متفاوت است.

توجه: ورودی `prompt` نباید خالی باشد. گره بررسی می‌کند که حداقل یک کاراکتر غیر از فاصله داشته باشد.

توجه: گره حداکثر 10 آیتم رسانه‌ای نخست را به‌صورت URL بارگذاری می‌کند، با اولویت ویدیو، سپس صدا و سپس تصاویر. هر رسانه باقی‌مانده به‌صورت درون‌خطی با base64 فرستاده می‌شود. مجموع رسانه درون‌خطی به 18 MB محدود است؛ در صورت تجاوز، گره خطایی ایجاد می‌کند و از شما می‌خواهد تعداد یا حجم رسانه‌های پیوست‌شده را کاهش دهید.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `STRING` | پاسخ متنی تولیدشده توسط مدل Gemini انتخاب‌شده. | STRING |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNodeV3/fa.md)

---
**Source fingerprint (SHA-256):** `d04d1e97a9c213297899291ad30db14a9f946b07506d0377fead4e29510c5ad9`
