10 月 17 日，DeepSeek 发布 DeepSeek-V4.1-Flash-1017，权重以 MIT 许可证开源在 Hugging Face（仓库 deepseek-ai/DeepSeek-V4.1-Flash-1017），模型上下文窗口 1M、原生支持视觉输入、Flash 档并发上限 2500。更重要的是，官方 API 里的模型名依然是那一个熟悉的 deepseek-flash——不用改代码，调用自动路由到最新版。对开发者来说，它真正值得本周动手的原因很实在：官方搜索/抓取接口目前免费，11 月 1 日 0 点起才按量收费，免费窗口只剩最后几天。下面这条路径，你可以照着一步步跑通。
第一步：拿 Key，发一个最小请求。 在 DeepSeek 开放平台建一把 API Key，设为环境变量 DEEPSEEK_API_KEY。它的接口是 OpenAI 兼容的，base_url 填 https://api.deepseek.com；如果你想走 Anthropic 那套协议，用 https://api.deepseek.com/anthropic。一个对话请求只要指向deepseek-flash 即可：
“`bash
curl https://api.deepseek.com/chat/completions
-H “Authorization: Bearer $DEEPSEEK_API_KEY”
-H “Content-Type: application/json”
-d ‘{“model”:”deepseek-flash”,”messages”:[{“role”:”user”,”content”:”用三句话解释 KV Cache”}]}’
`
第二步：把它接进 Claude Code。 DeepSeek 提供了 Anthropic 兼容端点，几条环境变量就能让 Claude Code 跑在 Flash 上；需要百万级长上下文时，模型名后加 [1m] 后缀：
“`bash
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=’你的 DeepSeek API Key’
export ANTHROPIC_MODEL=’deepseek-flash[1m]’
claude
`
第三步：搭一条“搜索 + 抓取 + 回答”的最小管线。 这才是 10 月 18 日一起放出来的两个接口：POST /v1/tools/search 和POST /v1/tools/fetch。搜索请求参数里，query 限 1~128 个字符（按字符计，不是 token），count 取 1~50（默认 10），need_content 为true 时才返回全文。返回结果里有几个字段值得盯：rerank_score（0~3，官方建议以 ≥1.5 为高质量阈值，综合了相关性、权威度与新鲜度）、authority（0~4，≥3 为高权威，-1 表示未知）、snippet（100~200 字，给人看）与 summary（600~800 字，官方说明是”给模型读”）。它还支持 site:、-排除词、“精确短语”、lang:zh,en、after:2026-01-01 等检索语法。串起来就是一个能联网、能溯源的问答机器人：
“`python
import os, requests
BASE = “https://api.deepseek.com”
H = {“Authorization”: f”Bearer {os.environ[‘DEEPSEEK_API_KEY’]}”}
def search(q, n=8, need=False):
return requests.post(f”{BASE}/v1/tools/search”, headers=H,
json={“query”: q, “count”: n, “need_content”: need}).json()
def chat(prompt, context):
r = requests.post(f”{BASE}/chat/completions”, headers=H, json={“model”:”deepseek-flash”,
“messages”:[{“role”:”system”,”content”:”只依据资料回答,末尾列出引用URL。”},
{“role”:”user”,”content”:f”资料:n{context}nn问题:{prompt}”}]})
return r.json()[“choices”][0][“message”][“content”]
res = search(“DeepSeek V4.1 Flash 定价”, 5, True)
print(chat(“总结要点”, str(res)))
`
费用与“坑”，动手前务必看清。 定价上，Flash 输入分缓存命中与未命中，且区分闲时与峰时（峰时为北京时间工作日约 09:00–12:00、14:00–18:00），缓存命中输入低至每百万 token 0.003 美元，输出 0.6 美元（闲时）到 1.2 美元（峰时）；这是把长上下文的重复前缀做成缓存后的价格，别拿”未命中”的成本去预算。搜索与抓取按 0.75 美元/千次成功请求计费（约 5 元/千次），失败不扣钱、优先扣赠送余额，11 月 1 日 0 点起正式收费，此前免费。两点提醒：其一，官方发布页给出的 DeepSWE、Terminal-Bench 4.0 等一批跑分均为厂商自报数据，其评测所用 harness 由官方图表脚注指定，尚未见第三方独立复现，把它当参考而非结论；其二，关于最大输出长度，不同文档口径不一致（有 384K 与约 25.6 万 token 两种说法），在百万上下文里做长文生成时，稳妥做法是分次输出、别一次把窗口塞满。
