POST AI agent ready /v1/carbon/estimate

碳估算 API - 通过 Green Web Foundation 每页查看的二氧化碳排放量

获取 URL 并根据传输的字节估算每次页面浏览的二氧化碳排放量。使用可持续网页设计方法以及可配置的能源和碳强度系数。返回以克为单位的二氧化碳、以千瓦时为单位的能量、相对于中值网页大小的百分位数排名以及计算中使用的方法常数。

Endpoint

curl -X POST https://api.botoi.com/v1/carbon/estimate \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.wikipedia.org"}'

When to use this API

为您网站上的每个页面生成碳估算值。将结果汇总到可持续发展报告中，根据您的交通量显示每月估计的二氧化碳排放总量。与利益相关者共享报告或将其发布在您的网站上。

调用此端点并将 Cleaner_than_percent 值显示为网站页脚上的徽章。 “这个页面比 89% 的测试网页更干净。” 鼓励性能优化并与具有环保意识的用户建立信任。

添加一个 CI 步骤，在构建站点后调用此端点。如果每次页面浏览的 CO2 超过阈值（例如 0.5g），则构建失败。跟踪一段时间内的碳预算以及捆绑包大小和性能指标。

碳估算的准确度如何？

该估算基于页面传输大小和可持续网页设计方法。它提供方向估计，而不是精确测量。实际排放量取决于访问者的设备、网络以及为页面提供服务的数据中心的能源组合。

clean_than_percent 是什么意思？

这是传输的字节数多于测试 URL 的网页的百分比。分数 89 意味着页面传输的字节数少于中值样本的 89%。越高越好。

这是否考虑了图像和第三方脚本？

该估计仅基于初始 HTML 响应大小。它不加载图像、CSS、JavaScript 或第三方资源。对于整页的估计，请结合测量总页面重量的工具。

使用什么方法？

该计算遵循可持续网页设计模型，该模型估算每 GB 传输的能量并应用全球平均碳强度系数。为了透明度，每个回复中都包含方法常数。

我可以自定义碳强度因子吗？

不通过此端点。碳强度采用全球平均水平。如果您知道托管提供商的能源结构，则可以将自己的系数应用于响应中返回的 energy_kwh 值。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.