DeepSeek 网页版免费对话：V4 系列不限条数、无需绑卡即可上手

网页端是免费对话入口，若要写进自己的程序，则需要走 API：API 按 token 计费，与网页端免费额度是两套体系，需先在控制台创建密钥并保证账户有余额。以下以兼容 OpenAI 风格的对话补全接口为例。

一、准备密钥与 base_url

登录官方控制台创建 API Key 并妥善保存（页面通常只完整显示一次）。base_url 形如 https://api.deepseek.com，部分 SDK 要求带版本号写成 https://api.deepseek.com/v1，请以控制台文档实际显示为准。常用模型名可在控制台的模型列表或文档中获取，对话模型常见为 deepseek-chat，推理模型常见为 deepseek-reasoner，新版本上线后以控制台列表为准。

先把密钥写入环境变量，避免硬编码到代码里：

export DEEPSEEK_API_KEY="你的密钥"

二、发起一次对话补全调用

下面的 curl 请求可以直接复制运行，请求体使用 JSON，注意引号必须是英文直引号：

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一名简洁的技术助手"},
      {"role": "user", "content": "用三句话说明什么是 REST API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

Python 项目可用官方或兼容 OpenAI 的 SDK，只需替换 base_url 与模型名：

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com"
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一个 Python 冒泡排序"}],
    temperature=0.3,
    max_tokens=800
)
print(resp.choices[0].message.content)

三、关键参数说明

• model：模型名，对话与推理用途分别选对应模型，填错会直接报模型不存在的错误。
• messages：消息数组，role 取 system、user、assistant，system 用于设定角色与格式要求。
• temperature：随机性，取值一般在 0 到 1 之间，写代码、抽取结构化数据建议调低。
• max_tokens：单次回复的最大长度上限，设置过小会导致回答被截断。
• stream：设为 true 时以流式分块返回，适合做打字机效果，需要逐块拼接。

四、额度耗尽与限流的典型表现及排查顺序

常见表现：返回 401 表示密钥无效或未带 Authorization 头；返回 402 多为账户余额不足；返回 429 表示请求频率或并发超过限制；返回 503 通常是服务端繁忙。排查建议按以下顺序进行：

1. 先看 HTTP 状态码与响应体的错误信息，不要只看「请求失败」。
2. 确认密钥是否完整粘贴、环境变量是否在运行环境中生效、是否误用了网页端账号密码。
3. 到控制台查看余额与用量，余额不足时先充值再重试。
4. 核对模型名与 base_url 拼写，少写或多写 /v1 都可能导致 404。
5. 降低并发、加大重试间隔并做指数退避，遇到 429 不要立即密集重试。
6. 最后排查网络与代理设置，确认服务器可以正常访问外网接口。

建议在代码中对 max_tokens 与上下文长度做上限控制，并对失败请求记录状态码，便于区分是额度问题还是限流问题。