SuperAPI AI 工具集

billing

数据与分析

查看项目

更新于 10-31 15:09

技能介绍

用途

该技能用于回答与 Bright Data 账户资金相关的两类问题:一是账户已经花了多少,二是某个任务将来会花多少。第一类问题可以依据账户自身数据给出精确答案;第二类问题只能给出估算,且必须明确标注为估算。

主要能力

  • 查询账户余额与剩余额度:bdata budget balance,对应 GET /customer/balance;待扣费用需直接读取响应中的 pending_costs。
  • 查询单个区域的成本:bdata budget zone <name> --from <date> --to <date>,背后为 GET /zone?zone=<name> 与 GET /zone/cost?zone=<name>。
  • 查询所有活跃区域的成本:bdata budget zones --from <date> --to <date>,先 GET /zone/get_active_zones,再对每个区域调用 /zone/cost。
  • 查询各产品、区域、数据集或域名的成本:无 CLI 命令,直接调用 POST /costs/export/json。
  • 查询抓取成本:无 CLI 命令,直接调用 POST /costs/export/json,Web Scraper API 使用维度 web_apis,Scraper Studio 使用 collectors。
  • 查询区域列表(含已删除区域):无 CLI 命令,直接调用 GET /zone/get_all_zones。
  • 查询哪些网站消耗了预算:无 CLI 命令,直接调用 GET /domains/req 与 GET /domains/bw,必须提供日期。
  • 查询快照交付的记录数:无 CLI 命令,直接调用 GET /datasets/v3/snapshots?dataset_id=<id>,读取 dataset_size。

API 基础主机为 https://api.brightdata.com,认证头为 Authorization: Bearer <key>。密钥应从环境变量或 CLI 自身存储中读取,不得要求用户在对话中粘贴密钥,也不得打印密钥。CLI 登录后 BRIGHTDATA_API_KEY 未设置属于正常现象,因为登录只把密钥写入 CLI 存储。

使用方式

  • 使用 bdata budget zone 和 bdata budget zones 时始终传入 --from 与 --to,确保统计窗口准确。
  • 需要机器可读输出时直接调用端点而非余额命令。
  • /zone/cost 只能看到以区域计费的产品,如 Web Unlocker、SERP、Browser API 和代理网络;Web Scraper API 与 Scraper Studio 按数据集 ID 和采集器计费,不会出现在其中,应改用成本导出。
  • 计费与成本数据需要 Finance 或 Admin 权限的密钥,其中 Finance 权限最小。bdata login --api-key 需要全权限密钥,因此可用 Admin 密钥保持 CLI 登录,用 Finance 密钥调用 API。401 表示密钥缺失、被吊销或错误;403 表示密钥有效但权限不足,应说明缺少的权限而非重试;404 表示快照、任务或数据集 ID 有误或过期;区域名错误返回 422。

任务成本估算

没有任何端点返回报价,因此不能把估算当作 API 报价。估算分三步:确定产品的计费单位;按单位计数而非按输入计数(例如一个输入不等于一条记录,五个列表页各含二十个商品会产生一百条记录,十个 URL 是十次独立计费请求);使用账户自身费率而非公开价目表。Web Unlocker 与 SERP 可按成功请求计费,失败请求通常不计费,但启用自定义请求头或 Cookie 后每个请求都会计费;SERP 一次返回多页结果仍算一次请求。Web Scraper API 按交付记录计费,因输入错误失败的尝试仍会计费。Scraper Studio 按页面加载计费,文件下载按 GB 另行计费。Browser API 与代理网络按流量 GB 计费,部分代理套餐按 IP 固定收费。

账户处于自定义按量付费或预承诺套餐时,公开价目表可能不适用。可向 /zone/cost 查询某时段数据,用自定义桶的成本除以请求数得到实际费率;Web Scraper API 可读取快照记录数并结合成本导出计算每条记录实际费率。若账户无历史用量,可用 Admin 或 Finance 密钥读取 GET /pricing_plans 中 is_current: true 的套餐及其 product_prices(其中 req 为每千次请求价格)。仅当该读取被拒绝时,才参考公开价目表,并说明这是列表价而非本账户费率。不得凭记忆报价。

免费额度

符合条件的账户每月共享 5,000 免费积分,每月 1 日重置,未用部分不结转。Web Unlocker、SERP 和 Web Scraper API 每次请求或每条记录消耗 1 积分,Scraper Studio 每次页面加载消耗 1 积分。Browser API 按每 MB 流量 5 积分消耗同一池(自 2026-09-01 起生效)。自定义按量付费与预承诺套餐账户没有每月免费积分。代理网络不覆盖免费积分;新账户可获得一次性 2 美元试用额度(7 天有效),添加支付方式后再获 5 美元(30 天有效)。免费积分不在任何计费 API 中,/customer/balance 的 credit 字段是美元而非积分数量;免费额度与试用状态位于控制面板 brightdata.com/cp/billing/overview 的 Free Tier Credits 处,应引导用户前往查看,不能把余额为零当作免费积分已耗尽的证据。

限制与红线

该技能为严格只读:不得代用户添加支付方式、充值、设置自动续费、更改套餐、购买数据集或取消任何服务,即使被要求也应引导用户到 brightdata.com/cp/billing/settings 自行操作。不得运行真实任务或单个测试请求来试探费用。不得从余额响应读取 pending_balance 而应读取 pending_costs。不得把成本导出的每个键都当作日期,避免把 total 计入天数。不得在不带 --from 和 --to 的情况下报告区域成本。不得把空成本导出直接当作无消费的证据。不得以公开列表价冒充本账户费率。不得把估算呈现为 API 报价。不得原样输出 /zone?zone= 响应(其中含区域密码)。不得打印 API 密钥或要求用户在聊天中粘贴密钥。