Get Subscription Seat Details - Alibaba Cloud Model Studio

Prerequisites

You have obtained the AccessKey of an Alibaba Cloud account or a RAM user, and the identity has been granted the RAM permissions required to call this operation. We recommend that you set the AccessKey as the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET instead of hard-coding it.

Request description

HTTP method：GET
Request URL
Region
Endpoint
Singapore
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail
Authentication This operation is an Alibaba Cloud OpenAPI operation that uses AccessKey-based signatures (the ACS3-HMAC-SHA256 algorithm). The Authorization: Bearer {API_KEY} scheme is not supported. A request must carry the common headers x-acs-action: GetSubscriptionSeatDetails, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, and Authorization. We recommend that you call this operation with an Alibaba Cloud SDK or OpenAPI Explorer so that you do not have to calculate the signature yourself.

Region	Endpoint
Singapore	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail`

Request parameters

All parameters are passed in the query string. Array parameters (StatusList) use the Flat format: pass each element as ParameterName.N, where N starts from 1. For example, StatusList.1=NORMAL and StatusList.2=<second value>.

Parameter	Type	Required	Description
PageNo	integer	No	分页页号。默认值：1 取值范围：正整数。
PageSize	integer	No	分页参数：每页显示条数，默认值 10。
StatusList	Array	No	席位状态筛选列表
SeatId	string	No	席位 id
SeatType	string	No	席位类型（specType） standard - Standard seat pro - Pro seat max - Max seat
QueryAssigned	boolean	No	席位分配状态筛选项。true=已分配，false=未分配，null=全部

Response parameters

Parameter	Type	Description
Success	boolean	Whether the API call was successful: true: success false: failure
Code	string	Response status code.
Message	string	Response message.
Data	object	Business data.
Items	Array[Object]	数据项
	Array[Object]	数据项
InstanceCode	string	席位 instance code
EquityList	Array[Object]	当前生效的权益实例，对 TokenPlan 产品，该列表只会有一个生效的权益实例
	object
EquityType	string	权益类型（如 CREDITS、SPN、资源包等）
CycleInstanceId	string	权益 code（订阅 code，credits 场景下不需要消费）
CycleStartTime	integer	当前周期开始时间，毫秒
CycleEndTime	integer	当前周期结束时间，毫秒
CycleTotalValue	number	当前周期的总额度
CycleSurplusValue	number	当前周期的剩余额度
CycleVersion	integer	当前周期的时序版本
EndTime	integer	席位过期时间
SeatId	string	席位 ID
SpecType	string	Seat type. standard - Standard seat pro - Pro seat max - Max seat
StartTime	integer	席位开始时间
AssignedStatus	string	分配状态 ASSIGNED UNASSIGNED
AccountId	string	绑定的成员账号 ID
AccountName	string	成员账号名称
AccountEmail	string	成员账号邮箱
Status	string	席位状态： CREATING —— 创建中 NORMAL —— 有效状态 LIMIT ——欠费受限 RELEASE —— 到期释放 STOP —— 到期停机 REFUNDED —— 已退款
Total	integer	席位的总数量
PageNo	integer	页码，取值大于 0 且不超过 Integer 数据类型的最大值
PageSize	integer	每页条数。

Request example

This operation uses Alibaba Cloud OpenAPI signatures. In the following example, ${SIGNATURE} must be calculated with the ACS3-HMAC-SHA256 algorithm, and x-acs-date and x-acs-signature-nonce must be replaced with actual values.

curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail?PageNo=1&PageSize=10&StatusList.1=NORMAL&SeatId=seat-123456&SeatType=standard&QueryAssigned=true" \
    --header "x-acs-action: GetSubscriptionSeatDetails" \
    --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}"

Response example

{
  "Success": true,
  "Data": {
    "Items": [
      {
        "InstanceCode": "subs-1234567",
        "EquityList": [
          {
            "EquityType": "CREDITS",
            "CycleInstanceId": "123456",
            "CycleStartTime": 1788328800000,
            "CycleEndTime": 1790920800000,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "EndTime": 1790920800000,
        "SeatId": "seat_123456",
        "SpecType": "standard",
        "StartTime": 1788328800000,
        "AssignedStatus": "ASSIGNED",
        "AccountId": "acc_123456789",
        "AccountName": "ExampleName",
        "AccountEmail": "test@email.com",
        "Status": "NORMAL"
      }
    ],
    "Total": 100,
    "PageNo": 1,
    "PageSize": 10
  }
}

Error codes

If the call fails, an error message is returned. For more error codes and solutions, see Error codes.

​Prerequisites

​Request description

​Request parameters

​Response parameters

​Request example

​Response example