DeepSeek 助手（免费版）

概述

DeepSeek 以极高的性价比提供中文优化的对话、代码与推理能力，是个人开发者与小型项目接入大模型的理想选择。本助手将 API 调用流程整理为结构化指南，帮助你在 5 分钟内完成首次对话调用。

免费版覆盖日常使用最高频的场景：模型选择、单轮对话、代码生成、基础错误处理。

核心能力

能力一：模型选择指引

DeepSeek 提供三种主力模型，各有侧重：

输入: 用户提供能力一：模型选择指引所需的指令和必要参数。 处理: 解析能力一：模型选择指引的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回能力一：模型选择指引的响应数据,包含状态码、结果和日志。

能力二：对话请求模板

提供可直接复用的 HTTP 请求与脚本模板，支持单轮对话与短上下文多轮对话。

输入: 用户提供能力二：对话请求模板所需的指令和必要参数。 处理: 解析能力二：对话请求模板的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回能力二：对话请求模板的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：API、的中文对话助手、支持通用对话、代码生成与基础推、理能力、助手免费版是一个、的中文对话辅助工、帮助开发者以极低、成本接入大模型对、核心能力、提供三种模型选择、单轮与短多轮对话、基础错误处理与重、试策略、Token、用量预估参考、Use、when、模型调用、智能对话、Agent、LLM、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

错误处理

覆盖 API 限流、密钥无效、请求超时、响应格式异常等常见错误的处理策略。

输入: 用户提供错误处理所需的指令和必要参数。 处理: 解析错误处理的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回错误处理的响应数据,包含状态码、结果和日志。

能力四：Token 成本预估

提供输入/输出 Token 计费参考，帮助预估调用成本。

输入: 用户提供能力四：Token 成本预估所需的指令和必要参数。 处理: 解析能力四：Token 成本预估的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回能力四：Token 成本预估的响应数据,包含状态码、结果和日志。

错误场景2

检查error_code并按照处理方式进行排查。

错误场景3

使用场景

场景一：个人项目接入 AI 对话

独立开发者在个人博客或工具中加入 AI 问答功能，使用 deepseek-chat 模型以极低成本提供服务。

场景二：代码辅助

开发者使用 deepseek-coder 模型生成函数、解释代码、查找 Bug，提升编码效率。

场景三：学习大模型 API

初学者通过本助手的模板与示例，快速理解大模型 API 的请求结构与响应格式。

快速开始

第一步：配置 API Key

输入格式

# 设置环境变量（切勿硬编码到代码中）
export DEEPSEEK_API_KEY=sk-your-key-here

第二步：发送首次对话

# 使用 curl 快速测试
curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己"}]
  }'

第三步：使用脚本模板

// chat.js - 最小可用脚本
const apiKey = process.env.DEEPSEEK_API_KEY;
// ...
async function chat(message) {
  const resp = await fetch('https://api.deepseek.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'deepseek-chat',
      messages: [{ role: 'user', content: message }]
    })
  });
// ...
  if (!resp.ok) {
    throw new Error(`API 错误: ${resp.status} ${resp.statusText}`);
  }
// ...
  const data = await resp.json();
  return data.choices[0].message.content;
}
// ...
// 命令行调用
chat(process.argv[2]).then(console.log).catch(console.error);

示例

多轮对话模板

// 维护对话历史
const messages = [
  { role: 'system', content: '你是一个专业的编程助手' },
  { role: 'user', content: '什么是闭包？' }
];
// ...
// 后续追加 assistant 回复和新的 user 消息
// messages.push({ role: 'assistant', content: reply });
// messages.push({ role: 'user', content: '给个JavaScript示例' });

模型切换

// 代码场景使用 coder 模型
const codeModel = 'deepseek-coder';
// ...
// 复杂推理使用 reasoner 模型
const reasonModel = 'deepseek-reasoner';

最佳实践

实践一：密钥通过环境变量管理

永远不要将 API Key 写入代码或提交到版本库，统一通过环境变量注入。

实践二：设置合理超时

网络请求应设置超时（建议 30-60 秒），避免长时间挂起。

实践三：错误分类处理

实践四：按场景选模型

通用对话用 chat、代码用 coder、复杂推理用 reasoner，避免"一刀切"用最贵模型。

实践五：控制上下文长度

多轮对话的历史消息会持续消耗 Token，超出窗口后截断早期消息或做摘要压缩。

常见问题

Q1：API Key 在哪里获取？

访问 DeepSeek 官方平台注册账号，在控制台的 API 管理页面创建密钥。密钥以 sk- 开头。

Q2：调用费用大概是多少？

DeepSeek 定价极低，输入约 0.27 元/百万 Token，输出约 1.10 元/百万 Token。一次普通对话（约 500 Token）成本不到 0.001 元。

Q3：中文效果好不好？

DeepSeek 对中文理解优秀，特别适合中文问答、写作与翻译场景，在中文基准测试中表现处于第一梯队。

Q4：出现 429 限流怎么办？

免费额度或并发过高会触发限流。处理方式：降低请求频率、实现指数退避重试、升级到付费额度。

Q5：reasoner 模型为什么响应慢？

deepseek-reasoner 会执行多步推理链，生成时间显著长于 chat 模型。仅在对推理深度有要求时使用。

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• 运行时: Node.js 18+ 或 Python 3.8+ 或任意支持 HTTP 的环境

依赖详情

API Key 配置

• DeepSeek API Key: 通过环境变量 DEEPSEEK_API_KEY 注入
• 禁止: 在代码、脚本、SKILL.md 中硬编码 API Key
• 推荐: 使用 .env 文件管理密钥并加入 .gitignore

可用性分类

• 分类: MD+EXEC（纯Markdown指令，核心功能需要exec执行HTTP请求）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent调用 DeepSeek API 完成对话任务

已知限制

本免费体验版限制以下高级功能：

• 流式响应（SSE）处理（仅专业版提供）
• 函数调用 / 工具调用能力（仅专业版提供）
• 批量请求与并发管理（仅专业版提供）
• 多级缓存与成本优化策略（仅专业版提供）
• 自定义系统提示词模板库（仅专业版提供）
• 用量统计与预算控制面板（仅专业版提供）

解锁全部功能请使用专业版：deepseek-assistant-pro

输出格式

{
  "success": true,
  "data": {
    "result": "DeepSeek助手(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "deepseek assistant"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}