一、注册与获取API Key

做AI小程序最头疼的是API费用。DeepSeek的价格只有GPT的1/5，效果还相当能打。对于预算有限的小程序项目来说，DeepSeek是目前性价比最高的选择。

步骤1：注册账号

访问 https://platform.deepseek.com/，点击右上角「注册」。支持手机号或邮箱注册。注册完成后会自动登录。

步骤2：创建API Key

登录后，在左侧菜单点击「API Keys」→「创建API Key」。给Key起个名字（比如"测试"或"生产"），点击确定后Key会显示一次。

⚠️ 非常重要：API Key 只会在创建时显示一次，关闭页面后就看不到了。务必立即复制保存到安全的地方（比如密码管理器或.env文件）。如果不小心关了，只能删除重新创建。

步骤3：查看免费额度

注册后自动赠送 500万 tokens（输入+输出合计）。在「Usage」页面可以查看剩余用量。500万tokens大概可以生成250万汉字，个人使用几个月都用不完。

💡 提示：DeepSeek API和OpenAI的API完全兼容，所以你可以直接用 openai 库来调用DeepSeek，只需改一下 base_url 和 api_key 即可。

二、用curl测试（最快验证方式）

不管你是用什么语言开发，先用curl跑通一遍，确认API Key有效、网络通畅。

bash 
curl https://api.deepseek.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "用一句话解释什么是API"}
    ]
  }'

如果返回类似下面的结果，说明调通了：

json 
{
  "id": "abc123",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "API（应用程序编程接口）就像餐厅里的菜单——它告诉你你可以点什么（请求）以及你会得到什么（响应），而不需要你亲自去厨房（后台系统）操作。"
    }
  }]
}
⚠️ 注意： 如果 curl 报错，先确认 API Key 是否正确。常见错误：复制时多了空格、Key 已过期、或把对话API的地址写错了。

三、用Python调用

Python是调用AI API最常用的语言。DeepSeek兼容OpenAI的SDK，所以可以直接用 openai 包。

安装依赖

bash 
pip install openai

基础对话

python 
from openai import OpenAI

# 初始化客户端（关键：改 base_url）
client = OpenAI(
    api_key="sk-你的API_KEY",
    base_url="https://api.deepseek.com/v1"
)

# 发送对话请求
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个专业的编程助手"},
        {"role": "user", "content": "用Python写一个快速排序算法"}
    ]
)

print(response.choices[0].message.content)

流式输出（打字机效果）

流式输出可以让AI一边生成一边显示，用户体验更好：

python 
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API_KEY",
    base_url="https://api.deepseek.com/v1"
)

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "讲一个程序员笑话"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

四、用Node.js调用

安装依赖

bash 
npm install openai

基础对话

javascript 
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-你的API_KEY',
  baseURL: 'https://api.deepseek.com/v1'
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [
      { role: 'system', content: '你是一个有用的助手' },
      { role: 'user', content: 'Node.js如何读取文件？' }
    ]
  });
  console.log(response.choices[0].message.content);
}
main();

五、常用功能代码示例

1. AI自动写文章

python 
def generate_article(topic, style="专业"):
    """根据主题生成文章"""
    response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[{
            "role": "user",
            "content": f"请以{style}的风格，写一篇关于「{topic}」的800字文章。要求：有标题、有分段、有数据支撑。"
        }]
    )
    return response.choices[0].message.content

2. 智能客服自动回复

python 
def customer_service(user_message, history=[]):
    """智能客服，带上下文记忆"""
    messages = [{"role": "system", "content": "你是一个专业的电商客服，回答简洁有礼貌。"}]
    # 添加上下文历史
    for h in history[-5:]:  # 只保留最近5轮
        messages.append(h)
    messages.append({"role": "user", "content": user_message})
    
    response = client.chat.completions.create(
        model="deepseek-chat",
        messages=messages
    )
    return response.choices[0].message.content

3. 批量翻译

python 
def batch_translate(texts, target_lang="英语"):
    """批量翻译文本"""
    batch_text = "\n---\n".join(texts)
    response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[{
            "role": "user",
            "content": f"将以下文本逐条翻译成{target_lang}，保持原格式用---分隔：\n\n{batch_text}"
        }]
    )
    return response.choices[0].message.content.split("\n---\n")

六、常见错误及解决

错误代码 原因 解决方案
401 Unauthorized API Key 错误或已过期 检查 Key 是否完整复制，是否在后台被删除
429 Too Many Requests 请求频率过高 添加 sleep 或使用指数退避重试
400 context length exceeded 对话历史太长，超过模型上下文限制 截断历史消息，只保留最近几轮
timeout 网络连接超时 检查网络环境，是否被墙，加长timeout时间
503 Service Unavailable 服务端暂时不可用 等待几秒后重试
💡 最佳实践：在生产环境中，建议添加重试机制（retry）。Python可以用 tenacity 库，每次失败后等待2秒再重试，最多重试3次。

七、价格与免费额度

项目 价格
注册赠金 500万 tokens（输入+输出）
输入（用户提问） ¥0.5 / 百万 tokens
输出（AI回答） ¥2.0 / 百万 tokens
估算：一篇2000字文章 约 ¥0.01（一分钱）
估算：100万次客服对话 约 ¥500

对比一下：同样的用量如果用ChatGPT API，费用大约是DeepSeek的5-10倍。所以对于中文场景，DeepSeek是目前性价比最高的选择。

八、实际项目应用场景 & 代接服务

API调通了，然后呢？以下是我们用DeepSeek API做过并验证过的落地场景：

场景一：AI客服机器人

客户在小程序/网站提问，AI自动回复。我们用DeepSeek+微信小程序做过，运行稳定。适合电商、教育、服务类商家。

  • 接入方式：小程序前端 → 你的后端 → DeepSeek API
  • 成本估算：1000次对话 ≈ ¥0.5
  • 我们能帮做：¥500 整套部署

场景二：自动写日报/周报

对接企业微信或钉钉机器人，每天自动生成工作日报。员工只需输入关键词，AI生成完整报告。

场景三：AI合同/文档生成

我们已经做了灵犀AI合同生成器（线上运行中）。类似的思路可以做：AI简历生成、AI方案生成、AI论文辅助。

场景四：AI代码审查

把你的代码发给DeepSeek，它帮你检查Bug、优化性能、补充注释。接入CI/CD流水线后每次提交自动审查。