Troubleshooting¶

Having issues? Here are solutions to common problems.

Installation Issues¶

Dependency installation failed¶

# Clean cache
uv cache clean

# Reinstall
uv sync

Configuration Issues¶

ComfyUI connection failed¶

Possible Causes: - ComfyUI not running - Incorrect URL configuration - Firewall blocking

Solutions: 1. Confirm ComfyUI is running 2. Check URL configuration (default http://127.0.0.1:8188) 3. Test by accessing ComfyUI address in browser 4. Check firewall settings

LLM API call failed¶

Possible Causes: - Incorrect API Key - Network issues - Insufficient balance

Solutions: 1. Verify API Key is correct 2. Check network connection 3. Review error message details 4. Check account balance

Generation Issues¶

Video generation failed¶

Possible Causes: - Corrupted workflow file - Models not downloaded - Insufficient resources

Solutions: 1. Check if workflow file exists 2. Confirm ComfyUI has downloaded required models 3. Check disk space and memory

Image generation failed¶

Solutions: 1. Check if ComfyUI is running properly 2. Try manually testing workflow in ComfyUI 3. Check workflow configuration

TTS generation failed¶

Solutions: 1. Check if TTS workflow is correct 2. If using voice cloning, check reference audio format 3. Review error logs

Performance Issues¶

Slow generation speed¶

Optimization Tips: 1. Use local ComfyUI (faster than cloud) 2. Reduce number of scenes 3. Use faster LLM (e.g., Qianwen) 4. Check network connection

Other Issues¶

Still having problems?

Check project GitHub Issues
Submit a new Issue describing your problem
Include error logs and configuration details for quick diagnosis

View Logs¶

Log files are located in project root: - api_server.log - API service logs - test_output.log - Test logs