# 硅基流动 API Key 配置指南

## 🔑 配置 API Key

### 步骤 1: 检查 .env 文件

请确保 `.env` 文件中有以下配置（**不是 `.env.example`**）：

```bash
# 硅基流动 (SiliconFlow) - 可选
SILICONFLOW_API_KEY=sk-xxxxxxxxxxxxx  # 请替换为您的实际 API Key
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/chat/completions
SILICONFLOW_MODEL=deepseek-chat
```

### 步骤 2: 获取 API Key

1. 访问 [硅基流动官网](https://siliconflow.cn)
2. 注册/登录账号
3. 进入控制台，找到 API Key 管理页面
4. 创建或复制您的 API Key（格式通常为 `sk-xxxxxxxxxxxxx`）

### 步骤 3: 编辑 .env 文件

```bash
# 编辑 .env 文件
nano .env
# 或
vim .env
# 或使用您喜欢的编辑器

# 找到这一行：
SILICONFLOW_API_KEY=

# 替换为：
SILICONFLOW_API_KEY=sk-xxxxxxxxxxxxx  # 您的实际 API Key
```

### 步骤 4: 验证配置

运行以下命令验证配置是否正确：

```bash
source venv/bin/activate
python3 -c "from app.core.config import settings; key = settings.SILICONFLOW_API_KEY; print(f'API Key 已配置: {key is not None and key != \"\"}'); print(f'API Key 前10个字符: {key[:10] if key else \"未配置\"}')"
```

如果输出显示 "API Key 已配置: True"，说明配置成功。

### 步骤 5: 重启服务

配置完成后，需要重启服务：

```bash
# 停止当前服务
pkill -f "uvicorn app.main:app"

# 重新启动
source venv/bin/activate
nohup uvicorn app.main:app --host 0.0.0.0 --port 8000 > server.log 2>&1 &
```

## ✅ 验证配置是否生效

### 方法 1: 检查配置加载

```bash
source venv/bin/activate
python3 -c "from app.core.config import settings; print('API Key:', '已配置' if settings.SILICONFLOW_API_KEY else '未配置')"
```

### 方法 2: 测试接口

运行测试脚本：

```bash
./test_siliconflow.sh
```

或手动调用：

```bash
curl -X POST "http://localhost:8000/api/v1/inventory/ai-analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "tables": [
      {
        "raw_name": "t_user_base_01",
        "fields": [
          {
            "raw_name": "user_id",
            "type": "varchar(64)",
            "comment": "用户ID"
          }
        ]
      }
    ],
    "project_id": "project_001",
    "options": {
      "model": "deepseek-chat"
    }
  }'
```

## ⚠️ 常见问题

### 问题 1: API Key 配置后仍然显示未配置

**解决方案**:
- 确保编辑的是 `.env` 文件（不是 `.env.example`）
- 确保 API Key 没有多余的引号或空格
- 重启服务（配置只在启动时加载）
- 检查 `.env` 文件路径是否正确

### 问题 2: 401 Unauthorized 错误

**可能原因**:
- API Key 错误或过期
- API Key 没有权限
- API Key 格式不正确

**解决方案**:
- 重新生成 API Key
- 检查 API Key 是否正确复制（没有多余空格）
- 确认账号余额是否充足

### 问题 3: 服务启动失败

**解决方案**:
- 检查日志文件：`tail -f server.log`
- 确认 Python 环境和依赖已正确安装
- 检查端口 8000 是否被占用

## 📝 配置示例

### 正确的 .env 配置示例

```bash
# 硅基流动 (SiliconFlow)
SILICONFLOW_API_KEY=sk-1234567890abcdefghijklmnopqrstuvwxyz
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/chat/completions
SILICONFLOW_MODEL=deepseek-chat
```

**注意**:
- API Key 前后不要有引号
- API Key 不要有空格
- 等号两边可以有空格，但不建议

## 🚀 测试命令

配置完成后，可以使用以下命令快速测试：

```bash
# 1. 验证配置
source venv/bin/activate
python3 -c "from app.core.config import settings; print('✅ API Key 已配置' if settings.SILICONFLOW_API_KEY else '❌ API Key 未配置')"

# 2. 重启服务
pkill -f "uvicorn app.main:app"
sleep 2
source venv/bin/activate
nohup uvicorn app.main:app --host 0.0.0.0 --port 8000 > server.log 2>&1 &
sleep 3

# 3. 测试接口
./test_siliconflow.sh
```

---

**最后更新**: 2026-01-10