Files

4.1 KiB
Raw Permalink Blame History

Text-to-Image Node v1.7 - Quick Reference

What's New

🔧 Fixed

  • Reference Images: Now properly analyzed and incorporated into prompts
    • Analyzes: dimensions, brightness, color tones
    • LLM receives detailed characteristics to match

✨ New Controls

Prompt Length

Control the output size:

  • very_short - 20-40 tokens (minimal)
  • short - 40-80 tokens (SDXL)
  • medium - 80-150 tokens (Flux)
  • long - 150-250 tokens (complex)
  • very_long - 250-400 tokens (maximum detail)

Genre/Style

Infuse prompts with specific mood:

  • Creative: surreal, cinematic, dramatic, action, artistic
  • Horror: horror, noir
  • Tech: scifi, cyberpunk
  • Mood: humorous, romantic, indie
  • Era: vintage, modern
  • Content: pg, x-rated
  • Aesthetic: minimalist, maximalist, documentary

Subject Framing

Control the shot composition:

  • extreme close-up - Facial details
  • close-up - Face and shoulders
  • medium shot - Waist up
  • wide shot - Full body with environment
  • full body - Complete subject
  • cowboy shot - Mid-thigh up
  • Plus: bust shot, head and shoulders, three-quarter

Subject Pose

Control character positioning:

  • Static: standing, sitting, lying down, kneeling
  • Dynamic: action pose, walking, running, jumping, dancing
  • Portrait: portrait pose, contrapposto, asymmetric
  • Energy: relaxed, tense, dynamic, static

Quick Examples

Example 1: Cinematic Portrait

Prompt: "woman in evening dress"
Genre: cinematic
Length: medium
Framing: close-up
Pose: contrapposto

→ Film-quality portrait, dramatic lighting, classic pose

Example 2: Horror Scene

Prompt: "abandoned mansion"
Genre: horror
Length: long
Framing: wide shot

→ Detailed atmospheric horror with ominous mood

Example 3: Action Shot

Prompt: "superhero"
Genre: action
Length: short
Framing: wide shot
Pose: dynamic

→ Fast-paced, energetic, movement-focused

Example 4: Cyberpunk Character

Prompt: "{male|female} hacker"
Genre: cyberpunk
Length: medium
Framing: medium shot
Pose: asymmetric

→ Neon, tech, gritty urban dystopia aesthetic


Pro Tips

Reference Images

  • Use clear, well-lit references for best results
  • Color/lighting characteristics transfer well
  • Works with any ComfyUI-compatible image format

Combining Features

  • Alternation {a|b|c} + Emphasis (keyword:1.5) + Genre + Framing = powerful control
  • All features work together seamlessly
  • Random options provide variety across generations

Platform Specific

  • SDXL: Use short length, works with all genres
  • Flux: medium length, natural language excels
  • Pony: Any length converts to tags, genres adapt
  • Chroma: long or very_long for complex scenes

Length vs Detail

  • Shorter = focused, concise, faster to generate
  • Longer = complex scenes, multiple subjects, rich atmosphere
  • Match length to scene complexity

All New Inputs

Input Options Default
genre_style 22 options auto
prompt_length 6 options auto
subject_framing 14 options auto
subject_pose 17 options auto

All support:

  • auto - Intelligent defaults
  • random - Variety across generations
  • none - Disable the control
  • Specific values for precise control

Testing Checklist

  • Reference image incorporated (check output mentions image characteristics)
  • Prompt length matches target (count tokens ~words × 1.3)
  • Genre style reflected (vocabulary/tone matches)
  • Framing mentioned (shot type present)
  • Pose described (body position clear)
  • All features work together
  • Platform formatting correct
  • Emphasis syntax preserved (keyword:1.5)
  • Alternation processed {a|b|c}
  • No settings leakage in output

Restart Required

After update, restart ComfyUI completely to load new controls!


Files Updated

  • text_to_image_node.py - Core functionality
  • UPDATE_V17_ENHANCED_CONTROLS.md - Full documentation
  • This file - Quick reference

Version: 1.7
Status: ✅ Ready to use
Compatibility: ✅ All existing workflows work