Troubleshooting Guide

This guide helps you diagnose and resolve common issues when using buttonup's AI fashion photo generation platform.

Common Generation Issues

Generation Failures

Issue: "Generation Failed" Error

Symptoms:

• Generation process stops unexpectedly
• Error message: "Generation failed"
• No images returned

Possible Causes:

• Insufficient credits
• Invalid product images
• Network connectivity issues
• Server overload

Solutions:

1. Check Credits

   • Go to your account dashboard
   • Check your available credits
   • Purchase more credits or upgrade your plan if needed

2. Verify Product Images

   • Ensure images are high-quality (minimum 1024px)
   • Check for proper lighting and contrast
   • Remove distracting backgrounds
   • Verify image format (JPEG, PNG, WebP)

3. Network Issues

   • Check internet connection stability
   • Try again after a few minutes
   • Contact support if persistent

Issue: Poor Image Quality

Symptoms:

• Blurry or pixelated results
• Unrealistic model appearances
• Poor product integration
• Inconsistent lighting

Solutions:

1. Improve Source Images

   • Use higher resolution product photos
   • Ensure even, professional lighting
   • Remove shadows and reflections
   • Clean, simple backgrounds

2. Optimize Settings

   • Use higher resolution settings (2048x2048 recommended)
   • Set quality to maximum (95%)
   • Add custom prompts like "professional photography, high detail, realistic lighting"

3. Model Selection

   • Choose models with clear portfolio images
   • Match model characteristics to your brand
   • Test different model variants

Issue: Slow Generation Times

Symptoms:

• Generation takes longer than expected
• Timeout errors
• Incomplete batches

Solutions:

1. Optimize Batch Size

   • Reduce number of combinations per batch
   • Generate in smaller groups
   • Use parallel processing for multiple batches

2. Peak Time Avoidance

   • Generate during off-peak hours
   • Monitor platform status
   • Use queue management features

3. Technical Optimization

   • Use appropriate image resolutions
   • Avoid overly complex combinations
   • Simplify custom prompts

Product-Related Issues

Product Upload Problems

Issue: "Invalid Product Image" Error

Symptoms:

• Upload fails immediately
• Error: "Invalid product image"
• Image not processing

Solutions:

1. Image Format Check

   • Supported formats: JPEG, PNG, WebP
   • Ensure your image is in one of these formats

2. Size Requirements

   • Minimum: 512x512 pixels
   • Recommended: 1024x1024 pixels
   • Maximum: 4096x4096 pixels
   • File size: Under 10MB

3. Image Quality

   • Clear, well-lit photos
   • Minimal compression artifacts
   • Proper color balance
   • Sharp focus on product details

Issue: Product Not Appearing in Generation

Symptoms:

• Product uploaded successfully
• Not available in generator
• Missing from product list

Solutions:

1. Processing Time

   • Wait 2-5 minutes for processing
   • Check product status in dashboard
   • Refresh browser if needed

2. Category Assignment

   • Ensure correct product category
   • Verify product type (TOP, BOTTOM, FULL)
   • Check for category-specific requirements

3. Image Quality Issues

   • Re-upload with better quality
   • Ensure product is clearly visible
   • Remove background distractions

Product Integration Issues

Issue: Product Doesn't Fit Model Properly

Symptoms:

• Unrealistic product placement
• Distorted clothing
• Poor fit appearance

Solutions:

1. Model Size Matching

   • Choose appropriate model size variants
   • Match product size to model measurements
   • Test different size combinations

2. Product Image Quality

   • Use flat-lay product photos
   • Ensure consistent lighting
   • Avoid wrinkled or folded items

3. Pose Selection

   • Choose poses that complement product type
   • Avoid poses that stretch fabric unnaturally
   • Test different pose combinations

Model and Pose Issues

Model Selection Problems

Issue: Model Not Available

Symptoms:

• Selected model not found
• Error: "Model variant unavailable"
• Missing model options

Solutions:

1. Availability Check

   • Browse available models in your dashboard
   • Filter by gender and size preferences
   • Check if models are currently active

2. Size Variant Issues

   • Check all size variants for model
   • Verify model is active
   • Contact support for missing models

3. Regional Availability

   • Some models may be region-specific
   • Check your organization settings
   • Verify account permissions

Pose Compatibility Issues

Issue: Pose Not Suitable for Product

Symptoms:

• Unnatural product appearance
• Distorted clothing
• Poor visual results

Solutions:

1. Product-Pose Matching

   • Match poses to product categories
   • Avoid poses that don't suit product type
   • Test different pose combinations

2. Gender Compatibility

   • Ensure pose matches model gender
   • Check pose gender requirements
   • Use unisex poses when appropriate

3. Angle Considerations

   • Choose poses that showcase products
   • Consider front vs. back views
   • Test different angles

Background and Composition Issues

Background Integration Problems

Issue: Background Doesn't Match Scene

Symptoms:

• Unrealistic lighting
• Poor color coordination
• Inconsistent atmosphere

Solutions:

1. Style Coordination

   • Match background to product style
   • Consider brand aesthetic
   • Test different background types

2. Lighting Consistency

   • Choose backgrounds with compatible lighting
   • Avoid conflicting light sources
   • Use studio backgrounds for consistency

3. Color Harmony

   • Ensure background complements products
   • Avoid color conflicts
   • Test different color schemes

Composition Issues

Issue: Poor Overall Composition

Symptoms:

• Unbalanced image
• Distracting elements
• Unprofessional appearance

Solutions:

1. Element Balance

   • Ensure all elements work together
   • Avoid competing focal points
   • Maintain visual hierarchy

2. Brand Consistency

   • Align with brand guidelines
   • Maintain consistent style
   • Test different combinations

3. Quality Standards

   • Use high-quality source materials
   • Ensure professional appearance
   • Review before finalizing

Account and Access Issues

Account Problems

Issue: Access Denied or Login Problems

Symptoms:

• Cannot log into your account
• Access denied messages
• Account not found errors

Solutions:

1. Account Verification

   • Check your email for verification links
   • Ensure you're using the correct email address
   • Try resetting your password

2. Organization Access

   • Verify you have access to the correct organization
   • Check with your team administrator
   • Ensure your account is active

3. Browser Issues

   • Clear your browser cache and cookies
   • Try a different browser
   • Disable browser extensions temporarily

Issue: Generation Limits Reached

Symptoms:

• Cannot start new generations
• "Limit reached" messages
• Slow processing times

Solutions:

1. Plan Limits

   • Check your current plan limits
   • Consider upgrading to a higher tier
   • Wait for your monthly limit to reset

2. Usage Optimization

   • Reduce batch sizes
   • Space out your generations
   • Use fewer combinations per generation

3. Contact Support

   • Request limit increases if needed
   • Discuss custom plans for high-volume usage
   • Get assistance with optimization

Performance Optimization

Generation Speed Optimization

1. Image Preprocessing

   • Optimize source images
   • Use appropriate resolutions
   • Compress images efficiently

2. Batch Processing

   • Group related generations
   • Use parallel processing
   • Implement queue management

3. Caching Strategies

   • Cache successful combinations
   • Reuse effective settings
   • Store generated images locally

Quality Optimization

1. Source Material Quality

   • Use professional product photos
   • Ensure consistent lighting
   • Maintain high resolution

2. Parameter Tuning

   • Test different quality settings
   • Optimize custom prompts
   • Fine-tune generation parameters

3. Post-Processing

   • Apply quality filters
   • Enhance generated images
   • Batch process results

Getting Additional Help

Support Channels

1. Documentation

   • Check this troubleshooting guide
   • Review user guides and tutorials
   • Search our help center

2. Community Support

   • Join our user community forums
   • Share experiences and solutions
   • Learn from other users

3. Direct Support

   • Contact our support team
   • Provide detailed error information
   • Include steps to reproduce the issue

Reporting Issues

When reporting issues, include:

1. Error Details

   • Exact error messages
   • Screenshots if applicable
   • Timestamp of occurrence

2. System Information

   • Browser type and version
   • Operating system (Windows, Mac, etc.)
   • Internet connection type

3. Reproduction Steps

   • Detailed steps to reproduce
   • Expected vs. actual behavior
   • Any workarounds found

Best Practices

1. Prevention

   • Follow our best practices guides
   • Test with small batches first
   • Monitor your generation results

2. Monitoring

   • Track your generation success rates
   • Monitor any recurring issues
   • Keep track of what works best

3. Optimization

   • Regular review of your results
   • Continuous improvement of your process
   • Stay updated with new features

For more detailed information, check our user guides or contact our support team for personalized assistance.