Skip to main content

取得訂閱席位與額度統計

查詢訂閱席位與額度統計，包含訂閱週期、各類型席位數量、已分配席位数與剩餘 Credits。

前提條件

已取得阿里雲帳號或 RAM 使用者的 AccessKey，並已為其授予呼叫此 API 所需的 RAM 權限。建議將 AccessKey 設定為環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET，避免以明文寫入程式碼。

請求說明

  • HTTP 方法：GET
  • 請求地址

    地域

    Endpoint

    新加坡

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats

  • 驗證方式 此 API 為阿里雲 OpenAPI，採用 AccessKey 簽名（簽名演算法 ACS3-HMAC-SHA256），不支援 Authorization: Bearer {API_KEY} 方式。請求需攜帶公用請求標頭 x-acs-action: GetSubscriptionStats、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce 以及 Authorization。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫，可免去自行計算簽名。

請求參數

此介面無請求參數。

返回參數

參數

類型

描述

Success

boolean

呼叫介面是否成功：
true：成功
false：失敗

Code

string

回應狀態碼。

Message

string

回應訊息。

Data

object

業務資料

SubscriptionStartTime

integer

訂閱開始時間，毫秒

SubscriptionEndTime

integer

訂閱結束時間，毫秒

Items

Array[Object]

席位資訊清單（按 specType 分組）

object

清單資料

SeatType

string

席位類型（specType）
standard - 標準席位
pro - 進階席位
max - 尊享席位

SeatRefreshTime

integer

本週期重新整理時間，毫秒

TotalSeats

integer

總席位数

AssignedSeats

integer

已分配席位数

SeatCredits

number

席位總 Credits 額度

SeatRemainingCredits

number

本週期剩餘 Credits

請求範例

本介面使用阿里雲 OpenAPI 簽章，下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出，x-acs-date、x-acs-signature-nonce 需替換為實際值。 
curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats" \
    --header "x-acs-action: GetSubscriptionStats" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

返回範例 

{
  "Success": true,
  "Data": {
    "SubscriptionStartTime": 1788328800000,
    "SubscriptionEndTime": 1790920800000,
    "Items": [
      {
        "SeatType": "standard",
        "SeatRefreshTime": 1790920800000,
        "TotalSeats": 2,
        "AssignedSeats": 1,
        "SeatCredits": 100,
        "SeatRemainingCredits": 40
      }
    ]
  }
}

錯誤碼

如果呼叫失敗，會返回錯誤訊息。更多錯誤碼及解決方法，請參閱錯誤訊息。