BZcreativ-ComfyUI-FLUX-TOGETHER-API/USAGE.md

ComfyUI Together.ai FLUX API Node Usage Guide

Setup

1. Ensure you have a Together.ai account and API key
2. Configure your API key in config.ini
3. Install all required dependencies

Node Configuration

Input Parameters

Required Parameters:

• Prompt (String)

  • Your main generation prompt
  • Supports multiline input
  • Be specific and detailed for best results

• Negative Prompt (String)

  • Elements you want to avoid in the generation
  • Supports multiline input
  • Leave empty if not needed

• Steps (Integer)

  • Range: 1-100
  • Default: 20
  • Higher values generally produce better quality but take longer
  • Recommended range: 20-50 for most use cases

• Width (Integer)

  • Range: 512-2048
  • Default: 1024
  • Must be a multiple of 8
  • Common values: 512, 768, 1024

• Height (Integer)

  • Range: 512-2048
  • Default: 1024
  • Must be a multiple of 8
  • Common values: 512, 768, 1024

• Seed (Integer)

  • Range: 0 to max 64-bit integer
  • Default: 0
  • Use specific seeds to reproduce results
  • 0 or -1 for random seed

• CFG (Guidance Scale) (Float)

  • Range: 0.0-20.0
  • Default: 7.0
  • Controls how closely the image follows the prompt
  • Recommended range: 5.0-10.0

Output

The node outputs a single image tensor compatible with other ComfyUI nodes.

Best Practices

1. Prompt Engineering

   • Be specific and detailed in your prompts
   • Use descriptive adjectives
   • Include style references when needed

2. Performance

   • Start with lower step counts (20-30) for testing
   • Increase steps for final generations
   • Use reasonable image dimensions (1024x1024 is standard)

3. Error Handling

   • Check console for error messages
   • Verify API key is correctly configured
   • Ensure parameters are within valid ranges

Common Workflows

Basic Image Generation

1. Add Together API Node to workspace
2. Connect to a Load Image node
3. Configure prompt and basic parameters
4. Execute workflow

Advanced Usage

1. Combine with other ComfyUI nodes
2. Use seed control for consistent results
3. Experiment with guidance scale for style control

Troubleshooting

Common Issues

1. API Key Errors

   • Verify key in config.ini
   • Check API key validity
   • Ensure proper formatting

2. Generation Errors

   • Verify parameter ranges
   • Check prompt length
   • Monitor API rate limits

3. Image Quality Issues

   • Adjust step count
   • Modify guidance scale
   • Refine prompt

Examples

Basic Prompt Example

A beautiful landscape with mountains and lakes, cinematic lighting, high detail

Advanced Prompt Example

A stunning mountain landscape at sunset, volumetric lighting, 
golden hour, ultra detailed, professional photography, 
8k resolution, artistic composition

Negative Prompt Example

blur, haze, low quality, distortion, bad composition, 
oversaturated, unrealistic lighting

Support

For issues and feature requests, please use the GitHub issue tracker.