AI-Video/docs/en/troubleshooting.md

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?

1. Check project GitHub 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