Project/LLRiseTabBarDemo/API_KEY_CONFIGURATION.md

百度AI API密钥配置指南

前言

为了使AI商品识别功能正常工作，您需要配置百度AI开放平台的API密钥。本文档将指导您如何获取并配置这些密钥。

步骤1：注册百度AI开放平台账号

1. 访问 百度AI开放平台
2. 点击右上角「登录」按钮，如果没有账号请先注册
3. 完成实名认证（部分API需要）

步骤2：创建应用并获取API密钥

1. 登录后，进入控制台
2. 在左侧导航栏选择「图像识别」服务
3. 点击「创建应用」按钮
4. 填写应用信息：
   • 应用名称：建议填写项目名称，如"商品识别应用"
   • 应用类型：选择「移动应用」
   • 应用描述：简要描述应用用途
5. 勾选需要的接口，至少选择「通用物体和场景识别」和「商品识别」
6. 点击「立即创建」按钮

步骤3：获取API密钥

1. 创建成功后，在应用列表中找到您刚创建的应用
2. 复制「API Key」和「Secret Key」

步骤4：在应用中配置密钥

方法一：在代码中配置（开发测试阶段）

打开 BaiduImageRecognitionService.java 文件，在 getAccessToken() 方法中替换默认的密钥：

private String getAccessToken() {
    // 替换为您的API Key和Secret Key
    String apiKey = "iQRtDkCyWZ9EP1NHAVcyxHIl";
    String secretKey = "4waKrdNPh1cIQvnaO8FX5NgtW4LBLWeY";
    
    // 以下代码保持不变...
}

方法二：在配置文件中配置（推荐）

1. 在 app/src/main/res/values 目录下创建或编辑 strings.xml 文件
2. 添加以下内容：

<string name="baidu_api_key">iQRtDkCyWZ9EP1NHAVcyxHIl</string>
<string name="baidu_secret_key">4waKrdNPh1cIQvnaO8FX5NgtW4LBLWeY</string>

3. 修改 BaiduImageRecognitionService.java 文件：

private String getAccessToken() {
    // 从资源文件获取密钥
    String apiKey = context.getString(R.string.baidu_api_key);
    String secretKey = context.getString(R.string.baidu_secret_key);
    
    // 以下代码保持不变...
}

方法三：使用环境变量或安全存储（生产环境）

对于生产环境，建议使用Android Keystore或其他安全机制存储敏感信息：

1. 在构建配置中设置环境变量
2. 使用Gradle构建变量注入
3. 使用Android Keystore系统安全存储密钥

步骤5：测试配置

1. 编译并运行应用
2. 进入发布商品页面
3. 上传一张商品图片
4. 点击「使用AI识别商品信息」按钮
5. 如果识别成功并显示结果，则配置正确

注意事项

1. 密钥安全：请妥善保管您的API密钥，不要在公开代码中暴露
2. 配额管理：百度AI开放平台对API调用有免费额度和计费标准，请关注使用情况
3. 错误处理：如果出现"invalid api key"或"quota exhausted"等错误，请检查密钥配置和使用配额
4. 定期更新：如果密钥泄露，请立即在百度AI平台重新生成新密钥

常见问题排查

1. 认证失败：检查API Key和Secret Key是否正确
2. 配额不足：检查是否已达到免费调用额度
3. 网络错误：确保应用有网络权限且设备可正常联网
4. 参数错误：检查请求参数格式是否正确

参考文档

• 百度AI开放平台文档中心
• 百度AI开放平台SDK下载

如有其他问题，请参考百度AI开放平台的官方文档或联系技术支持。