用途
该技能用于回答与 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 密钥或要求用户在聊天中粘贴密钥。