DeepSeek 全家桶 API 接入说明

能力映射

定价以官方文档为准，可能调整。

整体架构与密钥安全

浏览器端不应直接持有 API Key——把密钥写进前端代码，任何人打开网页都能看到并盗用。正确做法是引入一个轻量后端代理，由它持有密钥并转发请求：

浏览器（拍照/上传）
   │  ① 图片转 base64，POST 到你的后端
   ▼
后端代理（持有 API Key，负责鉴权/限流/转发）
   │  ② 携带密钥调用 DeepSeek
   ▼
DeepSeek API（api.deepseek.com）

本项目前端已按此结构预留接口：assets/js/deepseek.js 中的 CONFIG.proxyUrl 指向后端代理地址，CONFIG.demoMode 设为 false 即切换为真实调用。

① 视觉识别隐患（核心）

调用多模态视觉模型，把现场照片交给 AI 判断隐患。示例请求（通过后端代理转发）：

POST {proxyUrl}
{
  "model": "deepseek-v4-flash-vision-exp",
  "messages": [
    { "role": "system", "content": "你是企业安全巡检助手，识别图中的安全隐患，输出隐患类型、严重程度、位置与整改建议，以 JSON 返回。" },
    {
      "role": "user",
      "content": [
        { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,..." } },
        { "type": "text", "text": "请找出图中所有安全隐患并给出整改建议。" }
      ]
    }
  ]
}

图片支持 base64 内联、外链 URL，或先经 Files API 上传后复用 file_id。

② 全家桶能力

DeepSeek 已发布「全家桶应用 API」，在对话中开启工具即可获得联网搜索、阅读链接、文件输入等能力，底层能力也开放独立接口（Search / Fetch / OCR / ASR / TTS），可单独或组合调用。

• 联网搜索：开启 deepseek_web_search 工具，支持文字/图片搜索，用于检索最新安全生产法规。
• 阅读链接：deepseek_read_url 工具抓取网页内容，用于读取法规文档页面。
• 文件输入：支持 PDF、Office、图片等格式，纯文本提取或图文混排解析。
• 模型安全：基础风控校验内置。

③ 视频巡检：抽帧方案

DeepSeek 官方目前暂无原生视频理解接口。本项目采用「抽帧 + 图像识别」方案：

视频文件
  │  按固定间隔（如每秒 1 帧）抽取关键帧
  ▼
逐帧调用视觉模型识别隐患
  │
  ▼
聚合去重 → 输出风险行为清单 + 时间戳定位

前端在 deepseek.js 的 detectVideo() 中已预留此流程，接入真实视觉模型后即可替换演示结果。

接入步骤

官方文档

• DeepSeek API 文档
• DeepSeek 发布全家桶应用 API