计费与点数
开发者平台以点数计费:只有成功拿到回答的任务扣点数,失败、取消、被拒绝的请求都不扣。
- 按成功任务计费。 每个
succeeded的任务扣一次点数;failed、canceled不扣。 - 按平台和档位定价。 每个平台有 P1 优先、P2 标准两档单价;不传
priority按 P2 计价。 - 单价在提交时锁定。 任务按提交那一刻的单价计费,之后调价不影响已提交的任务。
- 指定出口国家、开启思考模式都不加价。
- 查询不收费。 查询平台列表、查询任务、任务列表都不消耗点数。
- 账户内共用。 同一账户下所有 API Key、MCP 调用和控制台的在线调试共用一份点数余额。在线调试固定按 P1 单价计费。
- 首次使用赠送 1000 点。 第一次使用开发者平台时(进入开发者控制台,或用 API Key 调用任一接口),系统会自动向你的个人账户发放 1000 点,永久有效,不需要先创建 Key 或提交任务。每个账号只赠送一次,点数用完、更换或删除 Key 都不会再次发放。
- 充值:需要更多点数请联系商务。
赠送的点数计入点数余额,可以在控制台「概览」和「用量统计」查看。
两种方式:
单价按各平台的抓取成本制定,不同平台差别较大。程序里请以接口返回为准,不要写死。
点数怎么变化
Section titled “点数怎么变化”提交时先预占,到终态再结算。任务对象的 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。
- 先在少量问题上比较各平台的回答价值,只投放到真正需要的平台。
- 避免重复提交同一问题(见避免重复提交)。
