直连 DeepSeek V4.1 Flash 时，在 https://api.deepseek.com 使用 deepseek-flash。充值前先选平台与协议，估算任务费用，再配置同一平台签发的 Key。 本文沿着这条完整流程，从购买判断讲到第一次请求。
2026 年 9 月 11 日对照 DeepSeek 官方文档核查。代码经过文档与语法检查，没有做付费端到端测试；实际执行示例可能消耗余额。模型选型另见 DeepSeek、Gemini 与 Qwen 跨品牌对比。
1. 先选在哪个平台开通 API
官方更新日志确认直连 API 可用。第三方条目仍要单独验证：DeepSeek 的旧名称路由规则不能证明网关怎样映射模型。 目前可选的 API 接入渠道包括 DeepSeek 官方平台、OpenRouter 以及 等第三方聚合网关，各平台在限速策略、支付方式和可用地区上存在差异，建议根据实际部署环境对比后再决定注册哪个账户。
| 调用平台 | 本次核查确认的范围 | 充值前检查 |
|---|---|---|
| DeepSeek 直连 API | 官方文档确认 deepseek-flash 对应 V4.1 Flash | 账户权限、当前价格和所需操作 |
| 读取的公开目录显示旧 DeepSeek 条目，本次未确认 V4.1 服务路由 | 实际模型版本与 ID、协议、账户价格及支付条款 | |
| 其他网关 | 本文未验证 | 自身当前目录、协议文档与计费条款 |
这一结果是核验边界，不是不可用的证明。供应商可以分别更新路由和显示标签；博客发布公告本身，也不能证明有可购买的路由。先明确所需操作：文本聊天、Codex Responses、Claude Code 工具和图片输入，需要分别检查兼容性。
使用 时，先查目录和认证文档。确认路由满足需求后，再创建账户并准备 API Key。网关账户不会为 DeepSeek 直连账户增加余额。
2. 充值前先算费用
以下是DeepSeek 直连 API 每百万 token 的美元价格，对照官方定价页核查，不是 报价。
| token 类别 | 低峰美元价格／百万 token | 高峰美元价格／百万 token |
|---|---|---|
| 缓存命中输入 | $0.003 | $0.006 |
| 缓存未命中输入 | $0.15 | $0.30 |
| 输出 | $0.60 | $1.20 |
高峰为周一至周五 UTC 01:00–04:00 和 06:00–10:00，其余为低峰。对应北京时间 09:00–12:00、14:00–18:00，东京和首尔时间 10:00–13:00、15:00–19:00。有夏令时的地区应按具体时区换算。跨计价边界的请求，要查看实际计费规则，不能自行编造分段收费公式。
提示词重复，不代表全部输入按缓存计费。检查返回用量与账单。混合输入可以这样估算：
Cost = cached_input_tokens / 1_000_000 × cached_input_rate
+ uncached_input_tokens / 1_000_000 × uncached_input_rate
+ billed_output_tokens / 1_000_000 × output_rate
即缓存输入、非缓存输入和计费输出各自乘以对应费率后相加。例如 100 次请求，每次 10,000 个非缓存输入 token 和 2,000 个计费输出 token，合计 100 万输入、20 万输出：
Off-peak: (1 × $0.15) + (0.2 × $0.60) = $0.27
Peak: (1 × $0.30) + (0.2 × $1.20) = $0.54
off-peak 指低峰，peak 指高峰。不含供应商额外费用时，5 美元预算在低峰能覆盖 18 个完整的 100 次请求批次，高峰可覆盖 9 个。这不保证完成 1,800 个有用任务：Agent 可能多次调用、重试、累积历史，消耗的输出也可能超过最终可见答案所显示的量。
比较供应商时，用目标平台报价替换官方费率，并检查最低付款金额、购买手续费、时段和退款条件。增加余额前，先给一个完整的代表性任务制定预算。
3. 账户、Key 和型号要匹配
从实际调用的平台获取 Key。DeepSeek 平台签发的直连 Key 配 DeepSeek 端点， Key 配文档中的 路由。直连凭据保存在本地环境变量 DEEPSEEK_API_KEY 中，不要提交或打印。
使用准确模型 ID。官方 deepseek-flash 现在对应 V4.1 Flash。旧 Flash 名称是兼容别名，expires-on-0910 beta 配置则属于更早发布阶段。发布总览解释这些名称；已有 Pro 用户也应阅读 9 月 14 日迁移清单。
4. 用 Python 或 curl 发一次小请求
按官方快速入门，在项目环境执行 python -m pip install openai 安装兼容客户端，然后运行： 在正式集成前，可以先用 curl 向目标端点发送一条最小化请求来验证 Key 是否有效，例如针对 的兼容 OpenAI 格式端点，只需替换 base_url 和 Authorization 头即可在 Python openai 库中完成首次调通。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "Reply with one short greeting."}],
max_tokens=128,
extra_body={"thinking": {"type": "disabled"}},
)
print(response.choices[0].message.content)
print(response.usage)
先不启用思考和工具，保持诊断任务简单。基础调用成功后，再逐项添加所需能力并核对文档参数。
等价 curl 请求如下：
curl --fail-with-body https://api.deepseek.com/chat/completions \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
--data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with one short greeting."}],"max_tokens":128,"thinking":{"type":"disabled"}}'
失败时保留脱敏后的错误正文，不要分享包含认证头的详细请求记录。JavaScript 的 OpenAI SDK 选项为 baseURL，模型和 JSON 字段不变；应按已安装 SDK 的接口填写，不机械照搬 Python 参数名。
5. 按客户端配置协议
| 客户端或操作 | 接下来检查什么 |
|---|---|
| Chat Completions | /chat/completions 与 messages |
| Codex | Responses 供应商设置和完整模型目录 |
| Claude Code | Anthropic 兼容基础路径、主模型别名和子代理 |
| 图片理解 | 支持的图片内容块与所选路由的视觉输入能力 |
客户端配置见 Codex 教程或 Claude Code 教程。文本回复不能单独验证工具循环、图片输入或流式解析器；主模型选择也不能证明每项辅助任务用哪个模型。
6. 先定位报错，再决定充值
模型找不到时，先核对目的平台与准确 ID。旧客户端目录可能没有 deepseek-flash，网关也可能用另一个 ID。不要假定各供应商的未知模型错误一样。 遇到 401 或 429 错误时，应先平台控制台的日志或 的请求记录页面确认是认证失败、配额耗尽还是速率限制，明确错误类型后再判断是否需要补充余额或申请更高的 RPM 上限。
官方错误码区分 401 认证、402 余额不足、400 请求格式、422 参数和 429 速率限制。充值针对已确认的余额问题，不能修复其他类别。控制重试次数，有计划地给临时失败设置请求间隔。
代表性任务成功后，记录型号、供应商、时间、token 用量和扣费，不保留秘密信息。把账单与预算比较，也检查结果是否有用。在实际路由上验证所需操作及其成本后，再增加预算。
参考来源
- ofox 文档：模型目录 — https://docs.ofox.io/zh/develop/models
