跳转到内容

计费与点数

开发者平台以点数计费:只有成功拿到回答的任务扣点数,失败、取消、被拒绝的请求都不扣。

  • 按成功任务计费。 每个 succeeded 的任务扣一次点数;failed、canceled 不扣。
  • 按平台和档位定价。 每个平台有 P1 优先、P2 标准两档单价;不传 priority 按 P2 计价。
  • 单价在提交时锁定。 任务按提交那一刻的单价计费,之后调价不影响已提交的任务。
  • 指定出口国家、开启思考模式都不加价。
  • 查询不收费。 查询平台列表、查询任务、任务列表都不消耗点数。
  • 账户内共用。 同一账户下所有 API Key、MCP 调用和控制台的在线调试共用一份点数余额。在线调试固定按 P1 单价计费。
  • 首次使用赠送 1000 点。 第一次使用开发者平台时(进入开发者控制台,或用 API Key 调用任一接口),系统会自动向你的个人账户发放 1000 点,永久有效,不需要先创建 Key 或提交任务。每个账号只赠送一次,点数用完、更换或删除 Key 都不会再次发放。
  • 充值:需要更多点数请联系商务。

赠送的点数计入点数余额,可以在控制台「概览」和「用量统计」查看。

两种方式:

  • 调用查询平台列表,每个平台的 p1_credits、p2_credits 即两档每次成功调用的点数。
  • 在开发者控制台的「计费说明」页查看各平台单价表。

单价按各平台的抓取成本制定,不同平台差别较大。程序里请以接口返回为准,不要写死。

提交时先预占,到终态再结算。任务对象的 credits 字段反映这个过程:

任务状态 credits 的值 余额的变化
queued、dispatching、pending、running 提交时的单价(预占) 预占这部分点数,可用余额相应减少
succeeded 提交时的单价 正式扣除
failed、canceled 0 预占的点数退回

可用余额 = 有效点数余额 − 进行中任务的预占点数。 提交时如果可用余额小于这次的单价,请求直接返回 1023,不会创建任务,也不会透支。

当前余额与冻结(预占)点数可以在控制台「用量统计」查看。计费尚未开通时,查询平台列表返回空列表,提交任务返回 1022。

  • 单个任务:任务对象的 credits 是这个任务计费的点数(成功)或预占的点数(进行中);实际执行档位以 raw_result.priority 为准。
  • 按 Key、平台、日期汇总:控制台「用量统计」按天、按平台、按来源(各个 API Key / 在线调试)拆分点数消耗与请求数,日期按北京时间划分;「API Key」页显示每个 Key 本月的消耗。
  • 自己汇总:用任务列表按时间翻页,对 status 为 succeeded 的任务累加 credits。注意任务列表只列出当前 Key 提交的任务。

预计消耗 = 问题数 × 每个问题投放的平台单价之和(仅成功的任务计费)。

例如:每天 50 个问题,分别发往豆包、DeepSeek、Kimi,都用 P2。假设三个平台的 P2 单价分别为 3、3、20 点(以接口返回为准),则每天最多消耗 50 ×(3 + 3 + 20)= 1300 点,失败的任务不计入。

降低成本的常见做法:

  • 批量、定时类任务用 P2。
  • 先在少量问题上比较各平台的回答价值,只投放到真正需要的平台。
  • 避免重复提交同一问题(见避免重复提交)。