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

3.2 KiB
Raw Blame History

百度智能云API密钥正确获取指南

🔍 问题诊断

您遇到的unknown client id错误表明当前的API密钥格式不正确。百度智能云的API密钥应该是纯字母数字格式而不是您之前配置的格式。

正确获取API密钥的步骤

1. 访问百度智能云控制台

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文件中:

# 百度智能云配置(图像分析)
BAIDU_API_KEY=您的正确API Key
BAIDU_SECRET_KEY=您的正确Secret Key

2. 重启应用

应用需要重启才能加载新的环境变量。

3. 验证配置

使用以下命令测试配置是否正确:

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密钥后您就可以使用以下功能

  • 📊 照片质量评分
  • 🔍 照片内容分析
  • 🎨 照片美学评分

祝您配置成功!