返回模型列表

DeepSeek V3.1

deepseekdeepseek/deepseek-v3.1

DeepSeek V3.1 is a hybrid model supporting both thinking and non-thinking modes. Features enhanced tool calling capabilities for agent-based tasks. Thinking mode maintains answer quality comparable to DeepSeek-R1 with improved response times.

DeepSeek-V3.1 于 2025 年 8 月 21 日发布,是 DeepSeek 首款混合推理模型:同一个 checkpoint 可通过 API 端点或聊天界面的 DeepThink 开关,在非思考模式(deepseek-chat)与思考模式(deepseek-reasoner)之间切换。它继承 V3 的 671B 总参数 / 37B 激活 MoE 主干,额外进行了 840B token 的长上下文续训,并更新了 tokenizer 与 chat template。工程上的核心亮点是:V3.1-Think 的质量与 DeepSeek-R1-0528 相当或更优,而响应速度明显更快。

对 TheRouter 路由层用户来说,价值显而易见:同一个 model ID 即可同时承载快速对话与深度推理负载,无需维护独立的 R1 路由逻辑。工具调用与多步 agent 任务经过针对性后训,SWE-bench Verified 达到 66.0、SWE-bench Multilingual 54.5、Terminal-bench 31.3,较 R1-0528 有显著提升。代码采用 MIT 许可、权重采用宽松许可,SGLang、vLLM、LMDeploy 等推理栈已支持,意味着自托管路径在工程上真实可行。

适合使用
  • • 需要可靠工具调用与 JSON 输出的 agent 编码与搜索任务,且不愿支付前沿模型价格
  • • 混合聊天场景:部分用户要即时答案,部分用户要可见思考链——通过端点或 UI 开关切换
  • • 需要 128K 长上下文推理的任务,V3.1 的续训对整库分析、长文档 CoT、多轮 agent 循环真正有帮助
  • • 对成本或合规敏感的自托管 fallback——与托管路径使用相同权重与 tokenizer
不适合使用
  • • 视觉或多模态输入——V3.1 纯文本;图像请路由 Claude Opus 4.7、Amazon Nova 2 Lite 或 GPT-5o
  • • 需要极致数学或研究能力的场景——V3.2-Speciale 或 V4-Pro 已存在且更优
  • • 生产路径应已迁移至 V4——V4-Flash / V4-Pro 已于 2026 年 4 月上线,是当前默认选择
上下文长度
128K
最大输出
33K
输入价格每百万 tokens
$0.6264每百万 Tokens
输出价格每百万 tokens
$1.81每百万 Tokens

模态能力

文本→文本

价格明细

类型费率
输入$0.6264 每百万 Tokens
输出$1.81 每百万 Tokens

支持参数

temperaturemax_tokenstop_ptoolstool_choiceresponse_formatreasoningstop

模型规格

发布日期2025-08-21api-docs.deepseek.com ↗已核实
架构671B 总参数 / 37B 激活的 MoE;在 V3 基础上进行 840B token 长上下文续训;新 tokenizer 与 chat templateapi-docs.deepseek.com ↗已核实
上下文窗口128K tokensapi-docs.deepseek.com ↗已核实
混合模式deepseek-chat → 非思考模式;deepseek-reasoner → 思考模式(通过 API 或 UI DeepThink 按钮切换)api-docs.deepseek.com ↗已核实
许可——代码MIThuggingface.co ↗已核实
许可——权重DeepSeek Model License(允许商用)huggingface.co ↗已核实
支持的推理后端SGLang、vLLM、LMDeploy、TensorRT-LLM、LightLLM、DeepSeek-Infer;支持 FP8 与 BF16;NVIDIA 与 AMD GPU;通过 MindIE 支持华为昇腾huggingface.co ↗已核实
后继版本DeepSeek-V3.2(2025 年 12 月)→ V3.2-Speciale(临时)→ V4-Flash / V4-Pro(2026 年 4 月)已核实

基准成绩

BenchmarkDistributionScoreSource
SWE-bench Verified
Pass@1;较 R1-0528(44.6%)大幅提升
66.0%api-docs.deepseek.com ↗
SWE-bench Multilingual
54.5%api-docs.deepseek.com ↗
Terminal-bench
31.3%api-docs.deepseek.com ↗
Aider
超过 Claude 3.5 Sonnet(70.6%)
71.6%localllm.in ↗
AIME 2025
Pass@1;较 R1-0528(70.0)提升 17.5
87.5%api-docs.deepseek.com ↗
GPQA Diamond
74.9%localllm.in ↗
MMLU-Redux
91.8%localllm.in ↗

API 使用示例

所有新集成都应使用下方示例中的全球端点 api.therouter.ai;旧中国加速端点已下线。

cURL
curl https://api.therouter.ai/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -d '{
    "model": "deepseek/deepseek-v3.1",
    "messages": [
      {"role": "user", "content": "Summarize the key points from this input."}
    ]
  }'

API 使用指南

完整 API 参考 →

对话

通过 deepseek-chat 别名或直接 model id 进行标准非思考对话。

cURL
curl -X POST https://api.therouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $THEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v3.1","messages":[{"role":"user","content":"Hello"}]}'

deepseek 其他模型

同类模型

跨供应商的相似能力档位

动态与变更

2026-04-24

V4-Flash / V4-Pro 上线;旧别名现指向 V4

DeepSeek-V4 家族成为默认。deepseek-chat 与 deepseek-reasoner 别名现解析至 V4-Flash 的非思考/思考模式。V3.1 仍可使用,但新项目不再推荐。

TheRouter 编辑重写api-docs.deepseek.com ↗
2025-12-01

V3.2 取代 V3.1 成为默认端点模型

deepseek-chat 与 deepseek-reasoner 均升级至 V3.2(非思考/思考)。V3.1-Terminus 是短暂的中间版本,聚焦语言一致性与 agent 修复。

TheRouter 编辑重写api-docs.deepseek.com ↗
2025-08-21

DeepSeek-V3.1:混合思考模型发布

DeepSeek 首款混合模型。单一 checkpoint 支持思考与非思考两种模式。在 agent 基准上显著提升(SWE-bench Verified 66.0),思考速度快于 R1-0528。

TheRouter 编辑重写api-docs.deepseek.com ↗

常见问题

如何在思考模式与非思考模式之间切换?

model='deepseek-chat' 为非思考模式,model='deepseek-reasoner' 为思考模式。在网页 UI 中切换 DeepThink 按钮。底层权重相同,仅推理模板不同。

新项目还推荐使用 V3.1 吗?

不推荐。V4-Flash / V4-Pro 已于 2026 年 4 月上线,是当前默认。V3.1 仍可用于兼容性,但新集成应以 V4 为目标,除非有特定理由留在 V3.1。

可以自托管 V3.1 吗?

可以。权重已在 Hugging Face 以宽松许可发布。支持的推理引擎包括 SGLang、vLLM、LMDeploy、TensorRT-LLM、LightLLM。自托管可完全掌控数据驻留与成本。

事实档案 — 本页每条断言可在此回溯来源
来源URL采集于
发布日期api-docs.deepseek.com ↗2026-05-25已核实
架构api-docs.deepseek.com ↗2026-05-25已核实
上下文窗口api-docs.deepseek.com ↗2026-05-25已核实
混合模式api-docs.deepseek.com ↗2026-05-25已核实
许可——代码huggingface.co ↗2026-05-25已核实
许可——权重huggingface.co ↗2026-05-25已核实
支持的推理后端huggingface.co ↗2026-05-25已核实
后继版本——已核实
SWE-bench Verifiedapi-docs.deepseek.com ↗2026-05-25已核实
SWE-bench Multilingualapi-docs.deepseek.com ↗2026-05-25已核实
Terminal-benchapi-docs.deepseek.com ↗2026-05-25已核实
Aiderlocalllm.in ↗2026-05-25待核实
AIME 2025api-docs.deepseek.com ↗2026-05-25已核实
GPQA Diamondlocalllm.in ↗2026-05-25待核实
MMLU-Reduxlocalllm.in ↗2026-05-25待核实
V4-Flash / V4-Pro 上线;旧别名现指向 V4api-docs.deepseek.com ↗2026-05-25已核实
V3.2 取代 V3.1 成为默认端点模型api-docs.deepseek.com ↗2026-05-25已核实
DeepSeek-V3.1:混合思考模型发布api-docs.deepseek.com ↗2026-05-25已核实
如何在思考模式与非思考模式之间切换?api-docs.deepseek.com ↗2026-05-25待核实
新项目还推荐使用 V3.1 吗?api-docs.deepseek.com ↗2026-05-25待核实
可以自托管 V3.1 吗?huggingface.co ↗2026-05-25待核实
帮助与联系