全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 账户

账户

GET /account
GetAccount

你的套餐、历史窗口、速率限制以及本周期剩余积分。可免费调用。每次响应都会通过 RateLimit-* 和 X-Credits-* 响应头返回相同的数值。

此操作不支持钱包支付；请使用账号认证。x402 支付指南。

参数

此端点无参数。

cURL 示例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/account' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许；Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

credits
object 可选

该账户本周期的积分状况；对于未计量的密钥则不存在。
credits.cycle_end
string (date-time) 必填

当前积分周期的 UTC 结束时间，届时套餐积分将续期。

credits.cycle_start
string (date-time) 必填

当前积分周期的 UTC 开始时间。

credits.plan_credits
integer (int64) 必填

套餐本周期包含的积分。

credits.plan_credits_remaining
integer (int64) 必填

本周期剩余的套餐积分。

credits.plan_credits_used
integer (int64) 必填

本周期已使用的套餐积分。

credits.purchased_credits_remaining
integer (int64) 必填

剩余未过期的已购积分，在套餐积分之后消耗。

credits.total_remaining
integer (int64) 必填

所有可消耗的剩余额度：套餐积分加上已购积分。

history_window_days
integer 必填

套餐可读取的天数范围；无限制时为 null。

plan
string 必填

该账户的 API 套餐，例如 free 或 pro。

rate_limit_per_minute
integer 必填

每分钟允许的请求数；密钥未受速率限制时为 null。

{
  "history_window_days": 3650,
  "plan": "pro",
  "rate_limit_per_minute": 300
}