查詢帳戶與限額

從原始碼生成 GET /account 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.4.0最後核實 2026-09-15

本頁目錄

操作

GET /account

operationId: account_v1_account_get

讀取當前帳戶、開發者訪問檔位、可選訂閱週期、Key 標識及權限和帳戶級限額，不返回金鑰。訂閱會提高限額，但不是訪問前提。恢復結果不明的冪等建立時，應保持相同 Key 身份。

鑑權與副作用

使用可信環境中的 Bearer API Key。所需權限：animations:read

此操作不啟動付費生成，其他狀態變化見上文說明。

引數

無路徑、查詢或操作專屬請求頭引數。

響應

HTTP	正文	含義
`200`	AccountResponse	成功的公開響應，示例數值僅用於說明。
`400`	APIErrorEnvelope	輸入錯誤，修正請求後再嘗試。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤銷。
`403`	APIErrorEnvelope	帳戶資格、帳戶狀態或 Key 權限不允許此操作。
`404`	APIErrorEnvelope	資源不可用、不屬於當前使用者，或簽名無效/過期。
`429`	APIErrorEnvelope	觸發帳戶級速率或佇列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	內部錯誤，保留任務 ID 和冪等鍵，僅標記可重試時重試。
`503`	APIErrorEnvelope	服務或供應商不可用，僅 error.retryable 為 true 時重試。

響應頭

HTTP	響應頭	型別	含義
`429`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。
`503`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。

響應示例

json

{
  "api_key": {
    "id": "00000000-0000-4000-8000-000000000005",
    "scopes": [
      "animations:read",
      "animations:write"
    ]
  },
  "id": "00000000-0000-4000-8000-000000000004",
  "limits": {
    "concurrency": 1,
    "create_per_minute": 3,
    "other_per_minute": 60,
    "queue": 3
  },
  "object": "account",
  "plan": {
    "cancel_at_period_end": false,
    "code": "registered",
    "current_period_end": null
  }
}

這篇文件有幫助嗎？

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策

需要協助？聯絡支援

搜尋文件

查詢帳戶與限額

操作

鑑權與副作用

引數

響應

響應頭

響應示例

相關教程

這篇文件有幫助嗎？