For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt, and this page is available as Markdown at https://docs.reelway.ai/api-reference/account-and-usage.md.
REELWAY

余额与用量

账户维度的资金与身份查询。除标注公开的端点外,全部以账户凭证鉴权,只返回凭证所有者的数据。

账户身份

GEThttps://rcn.reelway.ai/v1/account/me鉴权:账户

完整资料(邮箱验证状态等)

GEThttps://rcn.reelway.ai/v2/account/me鉴权:账户

精简 {walletAddress, username, emailVerified}

余额

GEThttps://rcn.reelway.ai/v4/account/balance鉴权:账户

账户余额(BalanceV4 形状)

curl --fail-with-body https://rcn.reelway.ai/v4/account/balance \
  -H "api-key: $REELWAY_API_KEY"

作为余额监控与快速开始的第一调用:无副作用、廉价、可直接验证 Key 有效性。WebSocket 通道的 authenticated 首帧同样携带余额(balanceVersion: 2)。

流水

GEThttps://rcn.reelway.ai/v1/transactions/list?limit=<n>&offset=<n>鉴权:账户

流水分页;整页 50 条时返回 next=offset+页大小

响应 {transactions[], next}:next 存在时用其作为下一页 offset 继续翻页,缺失表示末页。适合对账与消费审计;按 Key 拆分的用量见控制台 Key 列表。

公告

GEThttps://rcn.reelway.ai/v1/announcements/active?platform=<name>鉴权:可选

有效公告,上限 50 条,pinned 优先;有凭证时排除已 dismiss

POSThttps://rcn.reelway.ai/v1/announcements/{id}/dismiss鉴权:凭证

标记公告为已读(幂等)

排行榜

GEThttps://rcn.reelway.ai/v1/leaderboard?type=<type>&period=<period>鉴权:可选

仅两类:consumption|spending(账本聚合)与 creations|jobs(完成项目数);period: day|lifetime

未实现类型返回 422(1001);上限 50 名,形状 {leaderboard[{rank, artist, value}]}。

控制台数据面(console)

/console/* 端点(GET /console/me、GET /console/ledger、GET /console/usage、GET /console/subscription 等)为控制台后端专用:以 service key + X-Console-User 断言头鉴权,供 dashboard.reelway.ai 调用,不面向第三方开发者。第三方用途请使用本页其余端点。