DeepSeek API 的 model 参数现在只有两个有效名字：deepseek-flash 和 deepseek-v4-pro（官方文档首页，核对时间 2026 年 11 月 3 日）。填对名字只是第一步，两个名字背后的实际版本、能力差异、价格档位都不一样；手里还有旧模型名的旧代码，也需要知道兼容机制才敢不动。这篇把映射关系、能力边界、按任务的填法一次讲全，配套的选型算账见DeepSeek flash 与 pro 怎么选。
两个模型名，各对应哪个版本
模型名不等于版本号——名字是入口，背后由具体版本提供服务。官方定价页的对应关系如下：
| model 参数填什么 | 实际服务的版本 | 定位 |
|---|---|---|
| deepseek-flash | DeepSeek-V4.1-Flash-1017 | 高频日常任务、视觉输入、高并发场景（并发上限 2500） |
| deepseek-v4-pro | DeepSeek-V4-Pro-0813 | 复杂推理任务（并发上限 500） |
版本号里的日期后缀（1017、0813）表示服务的具体版本。名字不变、版本可以升级——你按名字调用，服务端指向哪个版本是官方的事，这正是「按名字调用、不按版本调用」的意义：官方升级服务版本时，你的代码一行不用改。V4-Pro 正式版当时的更新内容见DeepSeek V4-Pro 正式版一篇。
旧模型名还能不能用
官方首页的原话是：deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 这两个旧名字仍然接受，但对应的模型已经退役，请求由 DeepSeek-V4.1-Flash-1017 接管，并且按 Flash 价格计费。三层信息拆开看：
一是不用急着改代码。旧名字不会报错，调用方法不变，请求照样被服务。二是计费跟着新模型走。填旧名字跑出来的账单，按 Flash 档价格扣，不会按已退役模型的旧价格算。三是行为由新版本决定。既然服务它的是 V4.1-Flash-1017，输出特征、能力边界都按这个版本算。稳妥做法是找时间把 model 字段统一改成 deepseek-flash，行为完全一致、名字也不再悬着——属于低成本的收尾动作，不改也不影响运行。
两个名字的能力差异在哪
官方定价页的功能矩阵里，两名字支持的功能面板大部分相同：JSON 输出、工具调用（Tool Calls）、Responses API、Anthropic API 格式、前缀补全（Beta）都是两个名字都可用；FIM 补全（Beta）两个名字都只在非思考模式下可用；上下文长度同为 1M，最大输出同为 384K。差异点有两处，都不难记：
第一处是视觉。图片输入只有 deepseek-flash 支持，deepseek-v4-pro 不支持视觉——如果你要发图片，model 只能填 flash。第二处是并发与价格。flash 并发上限 2500，v4-pro 是 500；价格上 v4-pro 大约是 flash 的四到五倍（1M 输出 token 闲时 flash 为 0.6 美元、v4-pro 为 1.98 美元，输入未命中闲时 0.15 美元对 0.66 美元，官方定价页口径）。并发数字对批量任务的影响不小：500 并发意味着压测时别按 flash 的水位给 v4-pro 排任务。
结构化输出这类功能细节，概念与通用写法见什么是结构化输出；两名字都默认开启思考模式，三档思考强度怎么配合任务，见DeepSeek 三档思考强度怎么选。
按任务填：一张判定表
| 你的任务 | model 填什么 | 理由 |
|---|---|---|
| 发图片（读表、看图找差异） | deepseek-flash | v4-pro 不支持视觉，别无选择 |
| 批量处理、高频调用、并发压力大 | deepseek-flash | 并发 2500 对 500，价格也低一截 |
| 多步推理、复杂代码改动、长链路分析 | deepseek-v4-pro | 重任务的档位，贵在推理深度 |
| 旧代码里写着 deepseek-v4-flash | 先不动，抽空改 deepseek-flash | 兼容期内不报错，改完名字与实际服务一致 |
一句话收束：日常和批量走 flash，重推理走 v4-pro，涉及图片只有 flash 一条路。两档怎么把成本算细（一次失败的代价、峰谷时段搭配），flash 与 pro 怎么选一篇有完整算例。
接入编码工具时模型名怎么填
用 Claude Code、GitHub Copilot 这类工具接 DeepSeek（官方有专门的接入指南），model 字段同样填这两个名字之一，容易出错的是 base_url：官方给两种格式——OpenAI 兼容格式用 https://api.deepseek.com，Anthropic 兼容格式用 https://api.deepseek.com/anthropic。工具配置里选了哪种 API 风格，就填对应的 base_url，混用会连不上。Codex 接入的完整步骤（含脚本改了什么、能力边界）见DeepSeek 接入 Codex 怎么配置。另有面向 agent 开发者的 DeepSeek Harness 开发者预览版，官方在首页有单独指引，用之前先读文档。
常见问题
- deepseek-chat 和 deepseek-reasoner 还能用吗？官方文档当前只列出 deepseek-flash 与 deepseek-v4-pro 两个模型名，更早的名字是否仍在兼容名单里，以官方文档当前版本为准——不猜、不试运行时赌兼容，调用前查一眼官方首页最省事。
- 填了退役的旧名字，账单怎么算？按官方口径：请求由 V4.1-Flash-1017 服务、按 Flash 价格计费。账单核对时按 Flash 档价格对数即可，详见DeepSeek API 报错对照里的错误码与扣费联动。
- 两个名字的峰谷半价都一样吗？峰谷机制对两个名字都生效（闲时半价，北京时间 9 到 12 点、14 到 18 点为峰时），但各自闲时价不同——flash 未命中输入 1M 为 0.15 美元，v4-pro 为 0.66 美元。批量任务挪闲时跑，两档都省。
信息来源
- DeepSeek 官方 API 文档首页「Your First API Call」（api-docs.deepseek.com，核对时间 2026-11-03）：两个模型名、旧名兼容与按 Flash 价计费、base_url 双格式、DeepSeek Harness 预览版；
- DeepSeek 官方定价页「Models & Pricing」（api-docs.deepseek.com/quick_start/pricing，核对时间 2026-11-03）：版本映射、上下文 1M 与最大输出 384K、功能矩阵（视觉仅 flash 支持）、价格表、并发上限 2500/500、峰谷时段 UTC 口径；
- 站内条目：DeepSeek（工具页）、Kimi 模型列表怎么看（姊妹篇）、DeepSeek 接口怎么调用。
