帳戶

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 額度已用完;回應會包含續約時間與已購買的額度餘額
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
}