# API 配置指南

本文档详细说明如何配置 DeepSeek 和 Gemini API。

## 📋 目录

- [DeepSeek API 配置](#deepseek-api-配置)
- [Gemini API 配置](#gemini-api-配置)
- [常见问题](#常见问题)

---

## 🚀 DeepSeek API 配置

### 1. 获取 API 密钥

1. 访问 [DeepSeek 平台](https://platform.deepseek.com/)
2. 注册账号并登录
3. 进入 [API Keys 页面](https://platform.deepseek.com/api_keys)
4. 点击"创建新密钥"
5. 复制生成的 API 密钥（格式：`sk-xxxxxxxxxxxxxxxx`）

### 2. 配置到应用

编辑 `app.py` 文件的配置区域（第 7-28 行）：

```python
# ==================== API 配置 ====================
API_KEY = "sk-your-api-key-here"  # 粘贴您的 DeepSeek API 密钥
API_BASE_URL = "https://api.deepseek.com/v1"
API_MODEL = "deepseek-chat"  # 或 "deepseek-coder"
API_TYPE = "deepseek"
# ==================================================
```

### 3. 可用模型

| 模型名称 | 适用场景 | 特点 |
|---------|---------|------|
| `deepseek-chat` | 通用对话 | 平衡性能，推荐使用 |
| `deepseek-coder` | 代码相关 | 代码理解和生成能力强 |

### 4. 费用说明

- 新用户通常有免费额度
- 按 token 计费，价格实惠
- 详见 [定价页面](https://platform.deepseek.com/pricing)

---

## 🌐 Gemini API 配置

### 1. 获取 API 密钥

1. 访问 [Google AI Studio](https://aistudio.google.com/app/apikey)
2. 使用 Google 账号登录
3. 点击"Get API Key"
4. 创建或选择项目
5. 复制生成的 API 密钥

### 2. 配置到应用

编辑 `app.py` 文件的配置区域：

```python
# ==================== API 配置 ====================
API_KEY = "AIzaSy-your-gemini-api-key-here"
API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta"
API_MODEL = "gemini-1.5-flash"  # 或其他可用模型
API_TYPE = "gemini"
# ==================================================
```

### 3. 可用模型

| 模型名称 | 特点 |
|---------|------|
| `gemini-1.5-flash` | 快速响应，适合实时交互 |
| `gemini-1.5-pro` | 更强大的理解和生成能力 |
| `gemini-pro` | 经典版本 |

### 4. 注意事项

- Gemini API 在某些地区可能需要网络代理
- 中国大陆用户推荐使用 DeepSeek API

---

## 🔒 安全建议

### 方法 1：环境变量（推荐）

不要直接在代码中硬编码 API 密钥，使用环境变量：

**Windows PowerShell：**
```powershell
$env:DEEPSEEK_API_KEY="sk-your-key"
python app.py
```

**Linux/Mac：**
```bash
export DEEPSEEK_API_KEY="sk-your-key"
python app.py
```

然后在代码中读取：
```python
import os
API_KEY = os.environ.get("DEEPSEEK_API_KEY", "")
```

### 方法 2：配置文件

创建 `config.json`（不要提交到 Git）：

```json
{
  "api_key": "sk-your-key",
  "api_base_url": "https://api.deepseek.com/v1",
  "api_model": "deepseek-chat",
  "api_type": "deepseek"
}
```

在代码中加载：
```python
import json

with open('config.json', 'r') as f:
    config = json.load(f)
    API_KEY = config['api_key']
    API_BASE_URL = config['api_base_url']
    # ...
```

---

## ❓ 常见问题

### Q1: API 请求失败，显示 401 错误

**原因**：API 密钥无效或未配置

**解决**：
1. 检查 API 密钥是否正确复制（无多余空格）
2. 确认密钥未过期或被删除
3. 重新生成密钥并更新配置

### Q2: 网络连接错误

**原因**：网络问题或 API 服务不可达

**解决**：
1. DeepSeek 用户：检查国内网络连接
2. Gemini 用户：可能需要配置网络代理
3. 尝试切换到 DeepSeek API（国内友好）

### Q3: 回复速度慢或超时

**原因**：网络延迟或 API 负载高

**解决**：
1. 检查网络连接速度
2. 调整超时设置（app.py 中的 `ClientTimeout`）
3. 尝试切换模型（如 flash 版本）

### Q4: 公式不渲染

**原因**：Chatbot 未启用 LaTeX 支持

**解决**：
确认 `gr.Chatbot` 包含 `latex_delimiters` 参数：
```python
chatbot = gr.Chatbot(
    latex_delimiters=[
        {"left": "$$", "right": "$$", "display": True},
        {"left": "$", "right": "$", "display": False}
    ]
)
```

### Q5: 如何限制 API 调用成本？

**建议**：
1. 在 API 平台设置使用限额
2. 代码中添加 `max_tokens` 限制
3. 监控 API 使用情况
4. 使用轻量级模型（如 flash 版本）

---

## 📞 获取帮助

- **DeepSeek 文档**：https://platform.deepseek.com/docs
- **Gemini 文档**：https://ai.google.dev/docs
- **项目 Issues**：[GitHub Issues 链接]

---

最后更新：2025年10月15日