| # Gemini Util - Configurable Options Guide | |
| ## Overview | |
| The Gemini Describe functionality has been enhanced with configurable options through two nodes: | |
| 1. **Gemini Util - Options**: Configuration node that defines how descriptions should be generated | |
| 2. **Gemini Util - Media Describe**: Processing node that accepts media and optional configuration | |
| ## New Gemini Util - Options Node | |
| ### Purpose | |
| This node provides granular control over description generation by separating configuration from media processing. Connect this node's output to the `gemini_options` input of the Media Describe node. | |
| ### Configuration Options | |
| #### API & Model Settings | |
| - **Gemini API Key**: Your Google Gemini API key | |
| - **Gemini Model**: Choose from available models (2.5-flash, 2.5-flash-lite, 2.5-pro) | |
| - **Model Type**: Text2Image or ImageEdit workflow type | |
| #### Description Control (New Boolean Options) | |
| - **Describe Clothing?** [Yes/No]: Include detailed clothing and accessory descriptions | |
| - **Describe Hair Style?** [Yes/No]: Include hair texture and motion (but not color/length) | |
| - **Describe Bokeh?** [Yes/No]: Allow depth of field effects and blur descriptions | |
| - **Replace Action with Twerking?** [Yes/No]: Replace video movement description with twerking content | |
| #### Text Options | |
| - **Prefix Text**: Text to prepend to generated descriptions | |
| ## Updated Media Describe Node | |
| ### Changes | |
| - **Removed**: API key, model selection, description mode combo box, prefix text | |
| - **Added**: Optional `gemini_options` input that accepts configuration from Options node | |
| - **Maintained**: All media handling capabilities (upload, random selection, image/video support) | |
| ### Backward Compatibility | |
| When no Options node is connected, the Media Describe node uses these defaults: | |
| - Describe Clothing: No | |
| - Describe Hair Style: Yes | |
| - Describe Bokeh: Yes | |
| - Replace Action with Twerking: No | |
| - API Key: Default development key | |
| - Model: gemini-2.5-flash | |
| ## Usage Examples | |
| ### Basic Usage | |
| 1. Add "Gemini Util - Options" node to workflow | |
| 2. Configure desired settings | |
| 3. Add "Gemini Util - Media Describe" node | |
| 4. Connect Options node output to Media Describe `gemini_options` input | |
| 5. Provide media input (image tensor or upload) | |
| ### Option Combinations | |
| #### For Minimal Descriptions (No Clothing, No Hair, No Bokeh) | |
| - Clean, simple descriptions focusing on core elements | |
| - Results in 3-paragraph structure: Subject, Cinematic, Style | |
| #### For Detailed Fashion Analysis (Clothing + Hair) | |
| - Comprehensive descriptions including garments and hairstyles | |
| - Results in 4-paragraph structure when clothing enabled | |
| #### For Sharp Focus Photography (No Bokeh) | |
| - Explicitly prevents depth-of-field language | |
| - Useful for product photography or architectural scenes | |
| ### System Prompt Improvements | |
| #### Enhanced Decisiveness | |
| All prompts now include instructions to avoid uncertain language: | |
| - ❌ "She appears to be wearing either lace tights or leggings" | |
| - ✅ "She wears black lace tights" | |
| #### Hair Style Option | |
| New granular control over hair descriptions: | |
| - When enabled: Includes texture and movement | |
| - When disabled: Completely omits hair references | |
| - Always excludes: Color and length (as before) | |
| #### Dynamic Paragraph Structure | |
| - 3 paragraphs: Subject, Cinematic, Style (no clothing) | |
| - 4 paragraphs: Subject, Cinematic, Style, Clothing (with clothing) | |
| - 5-6 paragraphs for video: Adds Scene and Movement sections | |
| ## Migration Guide | |
| ### For Existing Workflows | |
| Existing Media Describe nodes will continue working with default settings. To use new features: | |
| 1. Add Options node to workflow | |
| 2. Configure desired settings | |
| 3. Connect to Media Describe node | |
| 4. Remove any hardcoded API keys from Media Describe node | |
| ### Option Mapping | |
| Old combo box "Description Mode" maps to new options as follows: | |
| - "Describe without clothing" → Clothing: No, Hair: Yes, Bokeh: Yes | |
| - "Describe with clothing" → Clothing: Yes, Hair: Yes, Bokeh: Yes | |
| - "Describe without clothing (No bokeh)" → Clothing: No, Hair: Yes, Bokeh: No | |
| - "Describe with clothing (No bokeh)" → Clothing: Yes, Hair: Yes, Bokeh: No | |
| ## Benefits | |
| 1. **Modularity**: Configure once, use with multiple media nodes | |
| 2. **Flexibility**: Mix and match options as needed | |
| 3. **Clarity**: Each option has a clear purpose | |
| 4. **Extensibility**: Easy to add new options in the future | |
| 5. **Precision**: More deterministic descriptions without uncertainty | |
| ## Troubleshooting | |
| ### No Description Generated | |
| - Verify Options node is connected to Media Describe | |
| - Check API key is valid | |
| - Ensure media input is provided | |
| ### Unexpected Content | |
| - Review individual option settings | |
| - Check if hair/clothing/bokeh options match expectations | |
| - Verify model type (Text2Image vs ImageEdit) is appropriate | |
| ### Backward Compatibility Issues | |
| - Media Describe works standalone with defaults | |
| - Only connect Options node if you need custom configuration | |