AutoControlCourse/API_CONFIG.md

API 配置指南

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

📋 目录

• DeepSeek API 配置
• Gemini API 配置
• 常见问题

---

🚀 DeepSeek API 配置

1. 获取 API 密钥

1. 访问 DeepSeek 平台
2. 注册账号并登录
3. 进入 API Keys 页面
4. 点击"创建新密钥"
5. 复制生成的 API 密钥（格式：sk-xxxxxxxxxxxxxxxx）

2. 配置到应用

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

# ==================== 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 计费，价格实惠
• 详见 定价页面

---

🌐 Gemini API 配置

1. 获取 API 密钥

1. 访问 Google AI Studio
2. 使用 Google 账号登录
3. 点击"Get API Key"
4. 创建或选择项目
5. 复制生成的 API 密钥

2. 配置到应用

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

# ==================== 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：

$env:DEEPSEEK_API_KEY="sk-your-key"
python app.py

Linux/Mac：

export DEEPSEEK_API_KEY="sk-your-key"
python app.py

然后在代码中读取：

import os
API_KEY = os.environ.get("DEEPSEEK_API_KEY", "")

方法 2：配置文件

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

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

在代码中加载：

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 参数：

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日