GH/BAIDU_AI_SETUP.md

166 lines
4.5 KiB
Markdown
Raw Normal View History

# 百度智能云AI照片评分配置指南
## 📋 概述
数据提取与转换器现在支持使用百度智能云AI大模型进行照片质量评分和内容分析为您的照片提供专业的智能化评估。
## 🔑 获取百度智能云API密钥
### 1. 注册百度智能云账号
- 访问: https://cloud.baidu.com
- 注册并完成实名认证
### 2. 开通图像分析服务
1. 登录百度智能云控制台
2. 搜索"图像分析"或访问: https://cloud.baidu.com/product/imageprocess.html
3. 开通"图像分析"或"图像识别"服务
### 3. 创建应用获取API密钥
1. 进入控制台 → 产品服务 → 图像分析
2. 创建新应用
3. 记录以下信息:
- API Key
- Secret Key
## ⚙️ 配置环境变量
在`.env`文件中添加百度智能云配置:
```env
# 百度智能云配置(图像分析)
BAIDU_API_KEY=您的API Key
BAIDU_SECRET_KEY=您的Secret Key
```
## 💰 费用说明
### 免费额度
- 新用户通常有免费调用额度
- 具体额度请查看百度智能云产品页面
### 计费方式
- 按调用次数计费
- 具体价格请参考百度智能云官方定价
## 🎯 功能特点
### 1. **照片质量评分** 📊
- **总体评分**: 0-100分的综合质量评估
- **质量维度**: 清晰度、亮度、对比度、色彩平衡
- **改进建议**: 针对性的优化建议
### 2. **照片内容分析** 🔍
- **对象识别**: 自动识别照片中的物体和场景
- **内容摘要**: 智能生成照片内容描述
- **百度百科**: 关联对象的详细信息
### 3. **照片美学评分** 🎨
- **美学评分**: 构图、色彩、光线等美学维度
- **美学建议**: 提升照片美感的专业建议
- **艺术指导**: 摄影技巧和构图建议
## 🔧 故障排除
### 常见问题
**1. "百度智能云API密钥未配置"**
- 检查.env文件中是否已配置BAIDU_API_KEY和BAIDU_SECRET_KEY
- 确保API密钥正确无误
**2. "权限不足"**
- 确认已开通图像分析服务
- 检查API密钥是否有相应服务权限
**3. "网络连接失败"**
- 检查网络连接
- 确认防火墙未阻止请求
**4. "额度不足"**
- 检查百度智能云账户余额
- 确认免费额度是否已用完
### 测试配置
使用以下命令测试百度智能云配置:
```bash
cd d:\python\AI\data-extractor-converter
uv run python -c "from utils.baidu_image_analysis import check_baidu_config; print(check_baidu_config())"
```
## 🚀 使用说明
### 在应用中使用
1. 访问应用 → 选择"📸 AI照片评分"功能
2. 上传照片文件
3. 选择分析类型:
- **质量评分**: 评估照片技术质量
- **内容分析**: 识别照片内容
- **美学评分**: 评估照片艺术价值
### 支持的图片格式
- JPG/JPEG
- PNG
- GIF
- BMP
### 分析类型说明
#### 质量评分 📊
- **适用场景**: 技术质量评估、照片优化
- **输出内容**: 综合评分、维度分析、改进建议
- **使用建议**: 适合评估照片的技术质量
#### 内容分析 🔍
- **适用场景**: 内容识别、场景理解
- **输出内容**: 对象识别、内容摘要、百科信息
- **使用建议**: 适合了解照片内容和场景
#### 美学评分 🎨
- **适用场景**: 艺术评估、摄影学习
- **输出内容**: 美学评分、构图分析、艺术建议
- **使用建议**: 适合评估照片的艺术价值
## 💡 最佳实践
### 照片优化建议
1. **清晰度**: 确保照片清晰,避免模糊
2. **光线**: 使用自然光,避免过暗或过亮
3. **构图**: 遵循三分法则,保持画面平衡
4. **格式**: 使用高质量JPG或PNG格式
### 成本控制
1. **批量处理**: 尽量批量分析照片
2. **选择性分析**: 根据需要选择分析类型
3. **监控使用**: 定期查看使用量统计
## 📚 相关资源
- [百度智能云图像分析文档](https://cloud.baidu.com/doc/IMAGEPROCESS/s/ck3h6yf8e)
- [API密钥管理](https://console.bce.baidu.com/iam/#/iam/accesslist)
- [产品定价](https://cloud.baidu.com/product/imageprocess.html#pricing)
## ⚠️ 注意事项
1. **安全性**: 不要将API密钥提交到版本控制系统
2. **费用**: 注意监控使用量,避免意外费用
3. **网络**: AI分析需要稳定的网络连接
4. **隐私**: 避免上传包含敏感信息的照片
## 🌟 应用场景
### 个人使用
- 评估手机照片质量
- 学习摄影技巧
- 优化社交媒体图片
### 教育使用
- 摄影课程作业评估
- 图像处理学习
- 艺术创作指导
### 专业使用
- 摄影师作品评估
- 图像质量监控
- 内容识别分析