# 百度智能云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. **隐私**: 避免上传包含敏感信息的照片

## 🌟 应用场景

### 个人使用
- 评估手机照片质量
- 学习摄影技巧
- 优化社交媒体图片

### 教育使用
- 摄影课程作业评估
- 图像处理学习
- 艺术创作指导

### 专业使用
- 摄影师作品评估
- 图像质量监控
- 内容识别分析