简介:本文说明如何核实DeepSeek官方价格、接口参数与调用成本,区分已确认能力与待核实能力,并给出成本测算公式、代码示例和上线前检查清单。读者可据此避免按过期或错误信息决策,并在小规模样本验证后再扩大调用规模。
接入DeepSeek的新能力前,团队最容易犯的错误是照着旧文章或社区消息写代码,结果价格、模型名或工具参数与官方实际不一致。如何核实DeepSeek官方价格、接口参数与调用成本,决定了项目预算和上线节奏,是第一步要做的事。
本文给出一套可以反复使用的方法:先确认能力边界,再估算成本,最后用小规模样本验证接入。本文不列具体价格、模型名和工具参数,这些信息以官方文档和计费页为准,并会随时间变化。
常见的候选能力可以归为五类:联网搜索、网页内容读取、文件输入与OCR、语音识别与合成、内容安全审核。这份清单只是待核实的候选项,不代表每一项都已由DeepSeek官方开放。
每一项能力都需要先确认来源。它可能是DeepSeek官方接口,也可能是第三方服务或团队自建的模块。只有来自官方文档的能力,才能写成DeepSeek开放的能力。第三方服务和自建模块要单独标注,并说明它们的计费方和维护方。
对每一项能力,开发者还需要确认四件事:
此外,还要确认失败请求是否计费。超时、被拒绝或返回错误的请求,计费规则各不相同,这直接影响重试策略的成本。把这些信息写进设计文档,后续的成本测算和故障排查才有依据。
写第一行代码前,建议完成三项核实。
第一,找到官方API文档,确认模型名称、接口协议和工具的调用方式。不同接口协议对消息角色、工具定义的要求可能不同,应以文档中的示例为准。
第二,找到官方计费页面,记录价格、币种、计费单位和生效时段。价格可能因时段、套餐或活动而变化,因此要同时记录查询日期。
第三,确认失败请求是否计费,并把结论写入设计文档。
核实结果建议整理成表格,每项能力占一行:
| 字段 | 填写内容 |
|---|---|
| 能力名称 | |
| 来源类型 | 官方接口、第三方服务或自建 |
| 官方文档链接 | |
| 计费页链接 | |
| 查询日期 | |
| 计费单位 | |
| 使用限制 | 文件大小、页数、时长、并发、频率等 |
| 失败请求是否计费 | |
| 负责人 | |
| 复核周期 |
表格建议每季度复核一次,官方公告更新后随时复核。这样团队在回看时,能知道每个数字从哪里来、是哪天确认的。
测算前,先把计价字段列清楚:
字段补全后,再套用下面的公式。成本通常由模型Token费用和工具调用费用两部分组成。
模型Token费用的计算方式如下:
Token费用 = 输入Token数 / 1,000,000 × 输入单价 + 输出Token数 / 1,000,000 × 输出单价
工具调用费用按计费单位换算,例如:
搜索费用 = 搜索次数 / 1,000 × 每千次单价语音费用 = 音频时长(小时) × 每小时单价
下面的代码把这些公式写成函数。价格参数需要从官方计费页填入,代码本身不包含任何价格数字。
def estimate_token_cost(input_tokens, output_tokens, price_in, price_out):# price_in、price_out 单位为元/百万tokens,请从官方计费页填入return input_tokens / 1_000_000 * price_in + output_tokens / 1_000_000 * price_outdef estimate_search_cost(search_count, price_per_thousand):# price_per_thousand 单位为元/千次,请从官方计费页填入return search_count / 1_000 * price_per_thousand
测算要使用真实业务样本,而不是单次对话的理想值。统计口径要完整。输入Token应包含系统提示、历史消息、工具返回的内容,以及重试产生的请求。输出Token应计入每次实际返回的内容。长上下文、多轮对话和文档总结类请求的Token数,往往远高于预期。
建议从线上日志中抽取一周的请求,统计输入和输出长度的分布。只看平均值会掩盖少数长请求的影响,所以要同时看P50(中位数)和P95(高分位数)。按P95估算预算,可以覆盖大多数高成本请求。
def percentile(values, p):# values 为请求长度列表,p 取 50 或 95s = sorted(values)idx = round(p / 100 * (len(s) - 1))return s[idx]
如果请求集中在某些时段,且官方计费页显示高峰与非高峰价格不同,可以分别计算,再决定是否调整任务的执行时间。
下面是一个基础的OpenAI兼容格式调用示例。它只包含普通对话,不涉及工