DeepSeek V4.1 Flash
DeepSeek V4.1 Flash API 调用文档:使用官方 Chat Completions、Responses 或 Anthropic Messages API 调用,1M token 上下文,思考可开可关,支持图像输入。
DeepSeek V4.1 Flash 是 DeepSeek 快速、低成本的模型(DeepSeek 自己的 API 称之为 deepseek-flash)。它默认先思考再作答,你可以按请求关闭思考或设置其强度。向 SeedRouter 发送官方 DeepSeek 请求:修改 base URL 和 API key,保持请求体不变。
模型 ID
| 模型 ID | 上下文窗口 | 最大输出 | 推理强度 | 默认值 |
|---|---|---|---|---|
deepseek-v4.1-flash | 1M tokens | 384K tokens(393,216) | none、low、high、max | 思考开启,high |
输入:文本和图像。输出:文本。查看模型页了解当前价格。
快速示例
curl https://api.seedrouter.ai/v1/chat/completions \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "Give me three names for a coffee shop."}]
}'端点
| 格式 | 方法和路径 | 认证 |
|---|---|---|
| Chat Completions | POST https://api.seedrouter.ai/v1/chat/completions | Authorization: Bearer <key> |
| Responses | POST https://api.seedrouter.ai/v1/responses | Authorization: Bearer <key> |
| Anthropic Messages | POST https://api.seedrouter.ai/v1/messages | x-api-key: <key> 或 Authorization: Bearer <key>,加上 anthropic-version |
三个端点都返回 DeepSeek 的官方响应格式,流式与非流式均可。将 API key 保存在服务端代码中。
参数
Chat Completions 字段:
| 名称 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | deepseek-v4.1-flash。 |
messages | object[] | 是 | — | 文本消息;图像作为 image_url 部分传入(见图像输入)。 |
thinking.type | enum | 否 | enabled | enabled 或 disabled。 |
reasoning_effort | enum | 否 | high | none(关闭思考)、low、high 或 max。minimal 按 low 运行,medium 和 xhigh 按 high 运行。 |
max_tokens | integer | 否 | 8K;开启思考时 64K(max 强度时 128K) | 1–393216。包括推理内容。 |
stop | string or string[] | 否 | — | 停止序列。 |
response_format | object | 否 | {"type": "text"} | text 或 json_object。json_schema 返回 400。 |
tools | object[] | 否 | — | 函数工具;接受 strict。 |
tool_choice | string or object | 否 | 无工具时为 none,有工具时为 auto | auto 和 none 会生效。required 和指定函数会被接受,但不会强制调用。 |
stream | boolean | 否 | false | 以服务端发送事件的方式流式传输。 |
stream_options.include_usage | boolean | 否 | false | 每个数据块都带 usage,除最后一个外均为 null。 |
temperature | number | 否 | 1 | 0–2。思考模式下不起作用。 |
top_p | number | 否 | 1 | 0–1。思考模式下低于 0.95 的值按 0.95 运行;不开思考时固定为 1。 |
user_id | string | 否 | — | 你的终端用户标识。 |
logprobs、top_logprobs | — | 否 | — | 接受(top_logprobs 为 0–20),但不返回对数概率。 |
frequency_penalty、presence_penalty | — | 否 | — | 已被 DeepSeek 弃用:接受,但不起作用。 |
思考和强度
思考默认开启,强度为 high。用 "thinking": {"type": "disabled"} 或 "reasoning_effort": "none" 关闭思考;这样答案会立即返回,输出 token 也更少。max 在难题上投入最多的推理。推理内容在 reasoning_content 中返回,与 content 并列,按输出 token 计费。
当请求带有 tools 时,请把之前每条 assistant 消息连同其 reasoning_content 一起发回,这是 DeepSeek 对工具调用对话的要求。
图像输入
图像放在用户消息的 content 中,作为 image_url 部分传入,可以是公开的 http(s) URL,也可以是 base64 data URI:
{"role": "user", "content": [
{"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}},
{"type": "text", "text": "What does this chart show?"}
]}URL 最长 8192 个字符,指向的图像最大 32 MiB。将示例 URL 替换为你自己的公开可访问图像。
计费维度
查看模型页面上的当前费率。请求按其使用的 token 计费:
- 未命中缓存的输入 token(
prompt_cache_miss_tokens), - 命中缓存的输入 token(
prompt_cache_hit_tokens), - 输出 token(包括推理)。
费率取决于请求运行的时间。高峰时段为 UTC 周一至周五的 01:00–04:00 和 06:00–10:00;其余所有时间(包括周末)为非高峰时段,费率为高峰时段的一半。费用从完成响应报告的 usage 中扣除。失败的请求不会被计费。你的账户使用记录显示每个请求的确切费用。
输出
非流式 Chat Completions 请求返回:
{
"id": "bc86988e-...",
"object": "chat.completion",
"created": 1790585983,
"model": "deepseek-v4.1-flash",
"choices": [{
"index": 0,
"finish_reason": "stop",
"logprobs": null,
"message": {"role": "assistant", "reasoning_content": "...", "content": "..."}
}],
"usage": {
"prompt_tokens": 36,
"completion_tokens": 39,
"total_tokens": 75,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 36,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}设置 "stream": true 时,每个数据块都带有一个 delta,其中是 reasoning_content 或 content;data: [DONE] 之前的最后一个数据块携带用量。
Responses API 和 Codex
POST /v1/responses 接受 Responses 请求体:input、instructions、max_output_tokens、reasoning.effort(取值同上文的 reasoning_effort)、text.format(text 或 json_object;json_schema 会被接受但不强制执行)、tools(function 和 apply_patch 自定义工具)、tool_choice、temperature、top_p、top_logprobs、user 和 stream。推理内容以带 reasoning_text 内容的 reasoning 项返回,流式响应携带从 response.created 到 response.completed 的编号事件,推理内容在 response.reasoning_text.delta 事件中。该 API 是无状态的:previous_response_id、conversation 以及 web_search 等内置工具会被忽略,因此请在 input 中发送完整对话。
要在 Codex 中使用 DeepSeek V4.1 Flash,在 ~/.codex/config.toml 中添加一个 provider,并设置 SEEDROUTER_API_KEY:
model = "deepseek-v4.1-flash"
model_provider = "seedrouter"
show_raw_agent_reasoning = true
[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"Anthropic Messages 格式
为 Anthropic Messages API 编写的代码同样可以调用 DeepSeek V4.1 Flash:将 Messages 请求体发送到 /v1/messages,并设置 "model": "deepseek-v4.1-flash"。system、max_tokens、tools、tool_choice(auto、none)、thinking(enabled、disabled)和 temperature(0–2)会生效;output_config.effort 和 metadata.user_id 会被接受;top_k、stop_sequences 和 tool_choice any 不起作用。推理内容以 thinking 块返回。图像以 base64 或 url 来源传入。
错误
错误使用 {"error": {"code": ..., "message": "..."}} 格式(Messages 端点使用 Anthropic 的错误格式)。code 是来自公共错误目录的代码。失败的请求不会被计费。
建议
- 分类、提取等简单快速的步骤可关闭思考;推理、数学和代码任务保持开启。
- 将长的、重复使用的上下文放在提示开头:缓存输入的费率只有输入费率的一小部分。
- 大批量任务放在非高峰时段运行,届时所有费率都减半。
