DeepSeek 使用指南：网页、App 与 API 快速上手

网页端：最快看到回答效果

如果只是想先体验 DeepSeek 的对话能力，最省事的方式是从官网进入 Start Now。同一个官网页面也提供 API 访问和 App 下载入口，适合在试用后再决定是否转向移动端或开发接入。

如果网页或 App 明显变慢、请求失败，先不要急着改代码。DeepSeek 的服务状态页会发布 Web/APP 性能异常等事件的调查和解决状态。

手机 App：注意只走官方渠道

DeepSeek App 公告提示，用户可以在应用商店搜索 DeepSeek，也可以访问官网获取直接下载链接；公告同时强调，为避免被误导，应只从官方渠道下载。

费用也要分开看：App 公告写明 100% FREE - No ads, no in-app purchases，但 API 的费用应另看 Models & Pricing 文档，不要把 App 免费说明直接理解为 API 免费。

API 接入：从第一次调用开始

开发者接入 DeepSeek API 的核心步骤并不复杂：先创建 API Key，然后在请求头中使用 Authorization: Bearer <TOKEN> 的 Bearer 认证。 DeepSeek 文档说明，其 API 格式兼容 OpenAI，因此可以通过修改配置，在 OpenAI SDK 或兼容 OpenAI API 的软件中访问 DeepSeek API。

用于生成聊天回复的基础接口是 /chat/completions。该接口会根据请求体中的 messages 数组，也就是截至当前的对话内容，生成模型回复。

HTTP 请求骨架

下面是便于理解结构的模板。<DEEPSEEK_BASE_URL> 请使用官方 Quick Start 中的 base_url，<MODEL_ID> 则应从 Models & Pricing 或 List Models 中确认。

POST <DEEPSEEK_BASE_URL>/chat/completions
Authorization: Bearer <DEEPSEEK_API_KEY>
Content-Type: application/json

{
  "model": "<MODEL_ID>",
  "messages": [
    {
      "role": "user",
      "content": "用一段话介绍 DeepSeek。"
    }
  ]
}

还有一个容易混淆的点：DeepSeek Quick Start 说明，为兼容 OpenAI 而出现的 v1 写法与模型版本没有关系，不要把 URL 路径中的 v1 当成模型版本号。

用 Python 调一次

DeepSeek 官方指南中的示例采用 OpenAI(api_key=..., base_url=...) 创建客户端，并通过 client.chat.completions.create 发起调用。 把 API Key、base URL 和模型名放入环境变量后，可以用下面的结构完成一次最小调用：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['DEEPSEEK_API_KEY'],
    base_url=os.environ['DEEPSEEK_BASE_URL'],
)

response = client.chat.completions.create(
    model=os.environ['DEEPSEEK_MODEL'],
    messages=[
        {
            'role': 'user',
            'content': '用一段话介绍 DeepSeek。',
        }
    ],
)

print(response.choices.message.content)

模型名：别只抄旧教程

接入 API 时，最容易踩坑的地方往往不是代码，而是模型名。Quick Start 将 deepseek-chat 和 deepseek-reasoner 与 DeepSeek-V3.2 关联说明；但 Change Log 又提示，在当前阶段，这两个名称分别指向 deepseek-v4-flash 的非思考模式和思考模式。

因此，做新项目或准备上线时，建议把官方 Models & Pricing 和 List Models 作为最终依据，而不是只照搬博客、旧示例或历史别名。

输入敏感资料前，先看隐私和条款

DeepSeek 隐私政策说明，其适用于 DeepSeek 的 App、网站、软件及相关服务。 DeepSeek 也单独提供用户协议。 如果你准备输入个人信息、客户资料、未公开代码、内部文档或其他敏感内容，最好先核对这些文件，并结合自己所在组织的数据处理要求再决定怎么用。

App 安装也同理：DeepSeek App 公告明确提醒只从官方渠道下载，以避免被误导。

出问题时的快速排查清单

• 认证失败：确认已经创建 API Key，并按 Authorization: Bearer <TOKEN> 格式发送。
• 模型名报错：回到 Models & Pricing 或 List Models，重新确认当前可用模型名。
• 网页或 App 卡顿：查看 DeepSeek 服务状态页是否有 Web/APP 相关事件。
• 下载入口不确定：优先使用应用商店搜索或官网直接链接等官方渠道。
• 费用理解有偏差：App 公告中的免费说明和 API 计费文档应分开看。

一句话总结

普通用户从官网网页体验或官方 App 开始最直接；开发者则先创建 API Key，再用 Bearer 认证调用 OpenAI 兼容的 /chat/completions 接口完成第一次联调。 真正放进项目之前，再把模型名、价格、隐私政策和用户协议逐项核对一遍。