GH/BAIDU_API_GUIDE.md
AI Developer 2ec2c0a1ab feat: 完整的数据提取与转换器项目
- 添加MDF文件导出功能
- 集成阿里云OCR大模型识别
- 添加百度智能云AI照片评分
- 集成DeepSeek大模型创意文案生成
- 完善文档和配置管理
- 使用uv进行现代化依赖管理
- 添加完整的.gitignore配置
2026-01-08 20:25:49 +08:00

124 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 百度智能云API密钥正确获取指南
## 🔍 问题诊断
您遇到的`unknown client id`错误表明当前的API密钥格式不正确。百度智能云的API密钥应该是纯字母数字格式而不是您之前配置的格式。
## ✅ 正确获取API密钥的步骤
### 1. **访问百度智能云控制台**
- 打开: https://console.bce.baidu.com/
- 使用百度账号登录
### 2. **开通图像分析服务**
1. 在控制台搜索栏输入"图像分析"
2. 选择"图像分析"或"图像识别"服务
3. 点击"立即使用"开通服务
### 3. **创建应用获取API密钥**
1. 进入控制台 → 产品服务 → 图像分析
2. 点击"创建应用"
3. 填写应用信息:
- **应用名称**: 数据提取与转换器
- **应用类型**: 工具软件
- **应用描述**: 照片质量评分工具
4. 勾选需要的服务权限
5. 点击"立即创建"
### 4. **获取正确的API密钥**
创建应用后,您会看到类似这样的信息:
```
AppID: 12345678
API Key: xxxxxxxxxxxxxxxx
Secret Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```
**正确的格式示例:**
```
API Key: "AbCdEfGhIjKlMnOp" (16位字母数字)
Secret Key: "AbCdEfGhIjKlMnOpQrStUvWxYz012345" (32位字母数字)
```
## ⚠️ 常见错误格式
**错误的格式(不要使用):**
```
# 这种格式是错误的!
BAIDU_API_KEY=bce-v3/ALTAK-lZu9DdMGqrEIBSs0MKcA5/35732e937f95337ddac7a5984c865fe28a2e4eea
BAIDU_SECRET_KEY=ya2270c03f2bc4816889e5173d38290d0
```
**正确的格式:**
```
# 这种格式是正确的!
BAIDU_API_KEY=AbCdEfGhIjKlMnOp
BAIDU_SECRET_KEY=AbCdEfGhIjKlMnOpQrStUvWxYz012345
```
## 🔧 配置步骤
### 1. **更新.env文件**
将正确的API密钥添加到`.env`文件中:
```env
# 百度智能云配置(图像分析)
BAIDU_API_KEY=您的正确API Key
BAIDU_SECRET_KEY=您的正确Secret Key
```
### 2. **重启应用**
应用需要重启才能加载新的环境变量。
### 3. **验证配置**
使用以下命令测试配置是否正确:
```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())"
```
## 🎯 验证成功的标志
如果配置正确,您会看到:
```
配置状态: True
详细信息: 百度智能云配置正确
```
## 💡 故障排除
### 如果仍然遇到问题
1. **检查服务开通状态**
- 确认图像分析服务已开通
- 检查应用是否有相应权限
2. **验证API密钥格式**
- API Key: 应该是16位字母数字
- Secret Key: 应该是32位字母数字
3. **检查网络连接**
- 确保可以访问百度智能云API
- 检查防火墙设置
4. **查看错误详情**
- 如果仍有错误,查看完整的错误信息
- 根据错误信息进一步排查
## 📞 获取帮助
如果仍然无法解决问题:
1. **百度智能云文档**: https://cloud.baidu.com/doc/IMAGEPROCESS/s/ck3h6yf8e
2. **技术支持**: 在百度智能云控制台提交工单
3. **社区支持**: 搜索相关技术论坛
## 🚀 下一步
配置正确的API密钥后您就可以使用以下功能
- 📊 照片质量评分
- 🔍 照片内容分析
- 🎨 照片美学评分
祝您配置成功!