GH/BAIDU_API_GUIDE.md

124 lines
3.2 KiB
Markdown
Raw Normal View History

# 百度智能云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密钥后您就可以使用以下功能
- 📊 照片质量评分
- 🔍 照片内容分析
- 🎨 照片美学评分
祝您配置成功!