DeepSeek V4.1 Flash API 怎么调用：获取 key 并完成首次调用
DeepSeek V4.1 Flash API 调用教程：获取 API key，用 OpenAI SDK 调用，开启或关闭思考模式、流式输出、发送图片，并解决新手常见错误。
以 Markdown 阅读要调用 DeepSeek V4.1 Flash，你需要一个提供该模型的平台的 API key，以及一个带有其模型 ID 的请求。在 DeepSeek 自己的 API 上，模型名是 deepseek-flash，旧名称 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 也会被路由到它。在 SeedRouter 上，模型 ID 是 deepseek-v4.1-flash，一个 key 即可按量付费调用，使用官方请求格式：把 OpenAI SDK 指向 https://api.seedrouter.ai/v1，代码保持不变。
本指南使用 SeedRouter；请求体与 DeepSeek 自己的 API 相同。
DeepSeek V4.1 Flash API key 怎么获取？
- 登录 SeedRouter，打开 API keys。
- 创建一个 key 并复制；它只显示一次。
- 需要时再充值。新账户自带一小笔免费余额，没有订阅。
把 key 放在环境变量里，比如 SEEDROUTER_API_KEY，并且只在服务端代码中使用。
怎么用 Python 调用 DeepSeek V4.1 Flash？
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SEEDROUTER_API_KEY"],
base_url="https://api.seedrouter.ai/v1",
)
completion = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Give me three names for a coffee shop."}],
)
print(completion.choices[0].message.content)思考模式默认开启，所以消息里除了 content 中的回答，还会在 reasoning_content 中带上模型的推理过程。
怎么用 Node.js 或 cURL 调用？
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.SEEDROUTER_API_KEY,
baseURL: "https://api.seedrouter.ai/v1",
});
const completion = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "Give me three names for a coffee shop." }],
});
console.log(completion.choices[0].message.content);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."}]}'同一个 key 也可以用 Responses API（/v1/responses）和 Anthropic Messages 格式（/v1/messages）调用 deepseek-v4.1-flash。
怎么关闭思考模式或设置推理强度？
思考模式默认开启，推理强度为 high。用 thinking 关闭它，或用 reasoning_effort 选择推理强度。OpenAI SDK 通过 extra_body 传递 thinking。第一个请求关闭思考，回答最快、最便宜；第二个使用最高推理强度：
completion = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Classify: 'my card was charged twice'"}],
extra_body={"thinking": {"type": "disabled"}},
)
completion = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "How many primes are there below 150?"}],
reasoning_effort="max",
)reasoning_effort | 效果 |
|---|---|
none | 关闭思考 |
low | 简短推理 |
high（默认） | 适合大多数任务 |
max | 最难的问题 |
DeepSeek 还接受 minimal（按 low 运行）、medium 和 xhigh（按 high 运行）。在我们对一道质数计数题的测试中，关闭思考用了 2 个输出 token，low 用了 258 个，max 用了 319 个。推理按输出计费。
怎么流式输出回答？
加上 stream=True。开启思考时，推理过程先通过 delta.reasoning_content 返回，然后回答通过 delta.content 返回，最后一个 chunk 带有 token 用量：
stream = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Write a haiku about latency."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)可以发送图片吗？
可以。DeepSeek V4.1 Flash 原生支持读取图片。在 image_url 部分中发送公开 URL 或 base64 data URI：
completion = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}},
{"type": "text", "text": "What does this chart show?"},
],
}],
)图片 URL 最长 8,192 个字符，指向的文件最大 32 MiB。
会遇到哪些常见错误？
| 错误 | 原因 | 解决办法 |
|---|---|---|
response_format 报 400 | 不支持 json_schema | 使用 {"type": "json_object"}，并在提示中描述结构 |
temperature 或 top_p 报 400 | 超过 2 或超过 1 | 保持在范围内；开启思考时它们本来就影响不大 |
| 图片 URL 报 400 | 文件无法作为图片下载 | 检查 URL 是否公开且指向图片 |
| 401 | key 缺失或错误 | 检查 Authorization 请求头 |
错误返回 {"error": {"code": ..., "message": "..."}}，失败的请求不收费。
常见问题
DeepSeek V4.1 Flash API 兼容 OpenAI 吗？
兼容。它接受 Chat Completions 和 Responses 格式，所以只需改 base URL 和模型，OpenAI SDK 就能用。它也接受 Anthropic Messages 格式。
为什么模型 ID 和 DeepSeek 的不一样？
DeepSeek 在自己的 API 上把模型命名为 deepseek-flash。SeedRouter 使用 deepseek-v4.1-flash，让版本号成为名称的一部分。除此之外请求体完全相同。
一次 DeepSeek V4.1 Flash 请求要多少钱？
按 token 计费，根据所在时段按高峰时段或非高峰时段费率计费。DeepSeek V4.1 Flash 价格指南 提供实时费率和计费示例。
完整的参数列表在哪里？
DeepSeek V4.1 Flash API 文档 列出了每个字段，DeepSeek V4.1 Flash 页面 提供 playground 和实时价格。
