DeepSeek V4 完全使用指南：从注册到 API 实战

👁 388 次阅读

DeepSeek 是近年来最受关注的 AI 大模型之一，其 V4 系列以超高的性价比和强大的技术能力，在全球开发者社区中迅速积累了口碑。V4-Flash 开源公共 API 的发布，让更多用户能够以极低的成本获得顶级 AI 推理能力。本文将手把手教你从注册到 API 实战，全面掌握 DeepSeek V4 的使用方法。

一、认识 DeepSeek V4 系列

DeepSeek V4 系列目前包含两个主力模型：DeepSeek-V4-Flash 和 DeepSeek-V4-Pro。V4-Flash 是官方推出的公共测试版（Public Beta），主打高速推理与高并发，特别适合 Agent 类应用场景；V4-Pro 则是面向高精度场景的旗舰模型。两者均支持思考模式（Thinking Mode），在输出最终答案之前会先进行链式推理，显著提升回答质量。

二、快速上手：注册与基础使用

2.1 注册 DeepSeek 账号

访问 DeepSeek 官方网站（platform.deepseek.com），可以通过手机号快速注册。注册后登录即可进入控制台，在「API Keys」页面创建自己的 API Key。DeepSeek 支持 OpenAI 兼容格式，这意味着你可以直接使用 OpenAI 的 SDK 来调用 DeepSeek 的模型，无需额外学习新的 API 规范。

2.2 网页版与 App 使用

除了 API 接口，DeepSeek 也提供网页版（chat.deepseek.com）和移动端 App。网页版对话界面简洁直观，支持上传文件、联网搜索等功能。App 端支持语音输入，使用体验流畅。对于普通用户来说，网页版和 App 已经能满足日常写作、问答、编程辅助等需求；对于开发者和企业用户，API 接口则提供了更灵活的集成方式。

三、核心功能详解

3.1 思考模式（Thinking Mode）

思考模式是 DeepSeek V4 最强大的功能之一。官方文档说明，该模式默认开启，默认推理强度为 “high”。在思考模式下，模型会在输出最终回答之前先输出一段链式推理过程（Chain-of-Thought），通过 reasoning_content 参数返回。这个机制大幅提升了模型在数学、逻辑、编程等复杂任务上的准确率。

思考模式控制参数（OpenAI 格式）：

• 开启/关闭：{"thinking": {"type": "enabled/disabled"}}，通过 extra_body 参数传入
• 推理强度控制：{"reasoning_effort": "low/high/max"}

V4-Flash 推理强度映射：

请求强度	V4-Flash 实际映射	V4-Pro 实际映射
low	low	high
high	high	high
xhigh	high	max
max	max	max

注意：思考模式下不支持 temperature、top_p、presence_penalty、frequency_penalty 参数。设置这些参数不会报错，但也不会产生实际效果。

3.2 超长上下文：1M Token

DeepSeek V4-Flash 支持高达 1M Token（约 150 万汉字）的上下文长度，最大输出可达 384K Token。这意味着你可以一次性输入整本小说、完整代码库或长达数小时的会议转录稿，模型依然能够准确理解上下文并完成分析。这是目前同类模型中极少数能提供如此长上下文能力的模型之一。

3.3 工具调用（Tool Calls）

DeepSeek V4 支持在思考模式下进行工具调用。模型可以在推理过程中多次调用外部工具（如查询天气、获取日期、搜索数据库等），并将工具返回结果融入推理链，最终输出综合答案。官方文档特别强调：如果在请求中携带了 tools 参数，reasoning_content 必须在后续所有请求中完整回传，否则 API 会返回 400 错误。

四、API 接入实战

DeepSeek 提供完全兼容 OpenAI 格式的 API，这意味着你可以直接使用 OpenAI 的 Python SDK、Node.js SDK 甚至 curl 命令来调用 DeepSeek 模型。以下是逐步接入教程。

4.1 基础配置

API 地址：

• OpenAI 格式：https://api.deepseek.com
• Anthropic 格式：https://api.deepseek.com/anthropic

可用模型：

• deepseek-v4-flash（版本：DeepSeek-V4-Flash-0731）
• deepseek-v4-pro（版本：DeepSeek-V4-Pro）

4.2 使用 curl 快速测试

最简单的测试方式是通过 curl 调用 API，无需安装任何 SDK：

curl -X POST "https://api.deepseek.com/chat/completions"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "9.11 和 9.8，哪个更大？"}],
    "max_tokens": 1000
  }'

返回结果中，choices[0].message.content 是模型的最终回答，choices[0].message.reasoning_content 是思考过程。

4.3 使用 Python SDK

安装 OpenAI SDK：

pip install openai

基础调用示例：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.deepseek.com"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "用 Python 写一个简单的 Web 爬虫"}
    ],
    max_tokens=8000,
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}}
)

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

如果想关闭思考模式（例如在简单的问答场景中节省推理开销），将 thinking.type 设为 disabled 即可。

4.4 多轮对话与思考过程

在多轮对话中，思考模式的处理方式分两种情况：

1. 无工具调用时：前一轮的 reasoning_content 不需要参与后续上下文拼接，如果传给 API 也会被忽略。
2. 有工具调用时：reasoning_content 必须完整回传，否则 API 返回 400 错误。

这种设计既保证了工具调用场景下的推理完整性，又避免了无工具场景下不必要的上下文膨胀。

五、定价对比

DeepSeek 的定价策略极具竞争力。以下是官方最新定价（单位：美元/每百万 Token）：

模型	缓存命中输入	缓存未命中输入	输出	并发上限
deepseek-v4-flash	$0.0028	$0.14	$0.28	2500
deepseek-v4-pro	$0.003625	$0.435	$0.87	500

以 V4-Flash 为例，缓存命中时每百万 Token 仅需 0.0028 美元，几乎是市面上最具性价比的模型之一。考虑到上下文缓存机制（Context Caching），在重复使用相同系统提示词或对话前缀的场景下，大部分输入都能命中缓存，实际使用成本可能远低于标价。V4-Flash 的 2500 并发上限也意味着它足以支撑大规模生产环境。

六、实战技巧与最佳实践

6.1 控制输出长度

V4-Flash 最大输出 384K Token，但在日常使用中建议设置合理的 max_tokens 来避免不必要的超额输出。对于大多数对话场景，2000-8000 Token 即可满足需求。

6.2 善用缓存降成本

将系统提示词（System Prompt）写在前缀中，利用 DeepSeek 的上下文缓存机制，可以大幅降低输入成本。例如在 Agent 场景中，固定角色的描述语句可以放在每次请求的前缀中，让缓存命中率达到 90% 以上。

6.3 JSON 输出

DeepSeek V4 支持 JSON 输出模式，适合需要结构化返回数据的场景：

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "列出 5 个 AI 编程工具，以 JSON 格式返回"}],
    response_format={"type": "json_object"}
)

6.4 选择合适模型

两个模型各有侧重：

• V4-Flash：适合日常对话、编程辅助、内容生成、Agent 应用等场景。高并发（2500）、低成本，是大多数场景的最佳选择。
• V4-Pro：适合需要更高质量推理的场景，如数学证明、复杂逻辑分析、专业写作等。成本更高但输出质量也更高。

七、总结

DeepSeek V4 凭借其强大的思考模式、1M 超长上下文、极具竞争力的定价和 OpenAI 兼容 API，已经成为 AI 开发者工具箱中不可或缺的一员。无论是个人用户通过网页版完成日常写作和编程，还是企业开发者通过 API 构建智能应用，DeepSeek V4 都提供了出色的体验。

核心要点回顾：

• 两个模型：V4-Flash（高性价比）和 V4-Pro（高精度）
• 思考模式默认开启，可通过 reasoning_effort 控制强度
• 1M Token 上下文，384K 最大输出，支持工具调用和 JSON 输出
• API 兼容 OpenAI 格式，可无缝迁移
• V4-Flash 缓存命中时仅 $0.0028/百万 Token，性价比极高

现在就可以去 DeepSeek 平台注册账号，获取 API Key，开始你的 AI 开发之旅了。

参考来源：
– DeepSeek 官方 API 文档：https://api-docs.deepseek.com/quick_start/pricing/
– DeepSeek 平台：https://platform.deepseek.com
– 思考模式文档：https://api-docs.deepseek.com/guides/thinking_mode/