Troubleshooting
Solutions for common issues in VariantLab.
Generation Issues
Image generation failed
Symptoms: Error message, generation doesn't complete
Solutions:
- Check your Mana balance - insufficient credits cause failures
- Try again - temporary API issues can cause failures
- Simplify your prompt if it's very complex
- Check your internet connection
Note: Failed generations are automatically refunded.
Generated image doesn't match prompt
Solutions:
- Be more specific in your prompt
- Include style keywords ("digital art", "flat illustration")
- Describe composition ("centered", "full body")
- Try regenerating - AI results vary
Image quality is low
Solutions:
- Use Gemini 3 Pro model for higher quality
- Increase resolution (Pro model supports up to 4K)
- Add quality keywords to prompt ("high detail", "sharp")
Detection Issues
Detection didn't find the trait
Solutions:
- Improve the detection prompt - be specific
- Check that the trait is visible in the image
- Run detection again - results can vary
- Create an empty mask and draw manually
Detection includes wrong areas
Solutions:
- Use the eraser tool to remove incorrect areas
- Write a more specific detection prompt
- Regenerate the mask
Mask edges are rough
Solutions:
- Zoom in and refine with brush/eraser
- Use smaller brush size for edges
- Take time on detailed edges
Variation Issues
Variation doesn't match style
Solutions:
- Include style in variation prompt: "red eyes, same digital art style"
- Be specific about maintaining consistency
- Regenerate and try different variants
Extracted layer has artifacts
Solutions:
- Check the mask - artifacts usually come from mask issues
- Refine mask edges in Detection
- Regenerate the variation
Variation changed too much
Solutions:
- Be more specific about what to change
- Mention what to keep: "only change the eye color"
- Try simpler modifications
Combination Issues
Layers are hiding each other
Cause: Incorrect layer order
Solution:
- Go to Detection page
- Check "Layer Order" section
- Arrange back-to-front (background first, foreground last)
Missing layers in combinations
Cause: Layers not favorited
Solution:
- Go to Variations page
- Click star on layers you want included
- Regenerate combinations
Combinations look wrong
Solutions:
- Check layer order (see above)
- Verify mask accuracy
- Preview individual layers
- Delete and regenerate combinations
Export Issues
Export is very slow
Cause: Large file count
Solutions:
- Wait - large exports take time
- Export in smaller batches
- Reduce combination count with limits
Downloaded ZIP is corrupted
Solutions:
- Try downloading again
- Use a different browser
- Check available disk space
- Contact support if persistent
Files have wrong names
Solution: Enable "Use display names" in export settings
Account Issues
Can't log in
Solutions:
- Check email/password are correct
- Use "Forgot Password" to reset
- Try a different browser
- Clear browser cache/cookies
Balance shows wrong amount
Solutions:
- Refresh the page
- Check transaction history for recent operations
- Contact support if discrepancy persists
Purchase didn't add credits
Solutions:
- Refresh the page
- Check transaction history
- Check email for receipt
- Contact support with transaction details
Browser Issues
Page won't load
Solutions:
- Refresh the page
- Clear browser cache
- Try a different browser
- Check internet connection
Features not working
Solutions:
- Use a modern browser (Chrome, Firefox, Safari, Edge)
- Enable JavaScript
- Disable browser extensions that might interfere
- Clear cache and reload
Canvas is blank
Solutions:
- Wait for image to load
- Check that an image exists in the project
- Refresh the page
- Try a different browser
Getting Help
If your issue isn't listed here:
- Check the relevant documentation section
- Try the suggested troubleshooting steps
- Contact support with:
- Description of the issue
- Steps to reproduce
- Screenshots if applicable
- Browser and device information