109 lines
1.9 KiB
Markdown
109 lines
1.9 KiB
Markdown
# Troubleshooting
|
|
|
|
Having issues? Here are solutions to common problems.
|
|
|
|
---
|
|
|
|
## Installation Issues
|
|
|
|
### Dependency installation failed
|
|
|
|
```bash
|
|
# 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?
|
|
|
|
1. Check project [GitHub Issues](https://github.com/AIDC-AI/Pixelle-Video/issues)
|
|
2. Submit a new Issue describing your problem
|
|
3. 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
|
|
|