返回网站 ↗
PUBLIC API · v2.0 · API KEY

把额度动态
接入你的产品.

V2 为开发者提供 API Key 鉴权、每日调用配额及使用统计。开发者可免费自助领取密钥,将 Codex、Claude、Grok 的额度事件和自动聚合 AI 资讯接入你的产品;旧版 V1 只读接口暂保留兼容。

API Key 认证 · 每日限额 · 原始来源可追溯

接口一览

所有接口都以当前域名为基址。建议设置至少 5 分钟缓存,避免对第三方来源反复发请求。

GET/api/v2/events

额度事件,可按平台、类别与条数筛选

GET/api/v2/news

来源可核验的 AI 资讯归档

GET/api/v1/health

接口版本、数据状态和入口说明

示例请求 · 只查看 Codex 重置卡
https://wbbbai.cc/api/v2/events?provider=codex&kind=banked&limit=20
类别说明:regular = 额度恢复,banked = 储备重置卡,notice = 尚未确认的公告,policy = 规则调整。原帖发布时间不等于个人到账时间。

复制即可运行

下面演示服务端 JavaScript 和 Python 调用。API Key 严禁写进浏览器或公开客户端代码。

JavaScript · Fetch API
async function getCodexBanked() {
  const url = 'https://wbbbai.cc/api/v2/events?provider=codex&kind=banked&limit=10';
  // API_KEY must stay on your server, never in public frontend JavaScript.
  const response = await fetch(url, { headers: {'X-API-Key': process.env.WBBBAI_API_KEY} });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  const { events, generatedAt } = await response.json();
  return { events, generatedAt };
}
getCodexBanked().then(console.log);
Python · requests
import requests
url = "https://wbbbai.cc/api/v2/events"
params = {"provider": "codex", "kind": "banked", "limit": 10}
import os
response = requests.get(url, params=params, headers={"X-API-Key": os.environ["WBBBAI_API_KEY"]}, timeout=10)
response.raise_for_status()
for event in response.json()["events"]:
    print(event["date"], event["title"], event["url"])

交给 AI 一键接入

把下面这段提示词复制给 Codex、Claude Code、Cursor、Windsurf 等开发助手,它们就能按你的技术栈自动完成接入。

AI 开发提示词 · 可直接粘贴
请在我现有的项目中集成 WBBBAI 额度雷达公开 API。

文档:https://wbbbai.cc/developers.html
额度事件:https://wbbbai.cc/api/v2/events
资讯:https://wbbbai.cc/api/v2/news

目标:
1. 增加一个「AI 额度动态」模块,展示 Codex、Claude、Grok 最新事件。
2. 清楚区分 regular(额度恢复)、banked(重置卡)、notice(预告)和 policy(规则变化)。
3. 支持按平台筛选,显示来源、原帖链接与公告日期。
4. 对接口响应缓存至少 5 分钟,并有错误状态、空状态、加载状态。
5. 将公告时间与实际到账时间区分,不把预测视为官方承诺。
6. 保留原始来源归属:WBBBAI 与各上游资料库。
7. 不要索取或保存用户的 ChatGPT/Claude/Grok 登录凭据。
8. 使用服务器端环境变量 WBBBAI_API_KEY 设置 X-API-Key 请求头;不要把密钥写入浏览器代码。
9. 兼容我的现有技术栈和设计系统,先检查项目结构再最小化改动。

请输出所修改的文件、完整实现以及测试结果。

返回字段

字段含义
providercodex / claude / grok
kindregular / banked / notice / policy
date / tsUTC 日期与发布时间(可能缺失精准时刻)
title / summary中文事实概要;勿当作官方全文
url原始出处链接(如可用)
confidence公开归类状态,不是个人到账证明
sources / generatedAt数据来源状态、站点生成时刻

接入须知

V2 接口必须提供 X-API-Key,密钥由站点管理员在受 Cloudflare Access 保护的后台签发,不要在浏览器或公开仓库泄露。目前不提供商业 SLA。建议请求频率低于每分钟一次,缓存至少五分钟;保留来源链接和署名。部分内容是非实时历史归档,第三方接口不可用时可能回退。调用 API 不会查询任何个人账户的剩余额度。

本项目为独立社区数据整理服务,与 OpenAI、Anthropic、xAI、Meta 无官方隶属。建议同时标注数据来源 CodexReset 和 ClaudeResets。