获取订阅席位与额度统计 - 阿里云百炼 Agent Studio

前提条件

已获取阿里云账号或 RAM 用户的 AccessKey，并已为其授予调用本接口所需的 RAM 权限。建议将 AccessKey 配置为环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET，避免明文写入代码。

请求说明

HTTP 方法：GET
请求地址
地域
Endpoint
华北2（北京）
GET https://modelstudio.cn-beijing.aliyuncs.com/tokenplan/subscription/stats
认证方式 本接口是阿里云 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 发起调用，可免去自行计算签名。

地域	Endpoint
华北2（北京）	`GET https://modelstudio.cn-beijing.aliyuncs.com/tokenplan/subscription/stats`

请求参数

该接口无请求参数。

返回参数

参数	类型	描述
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.cn-beijing.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
      }
    ]
  }
}

错误码

如果调用失败，会返回错误信息。更多错误码及解决方法，请参见错误信息。

​前提条件

​请求说明

​请求参数

​返回参数

​请求示例

​返回示例