Skip to main content

サブスクリプションシートおよび Credit 統計情報の取得

サブスクリプションシートおよび Credit の統計情報をクエリします。これには、サブスクリプション期間、タイプ別のシート数、割り当て済みシート数、および残り Credits が含まれます。

前提条件

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を取得しており、その ID にこの操作を呼び出すために必要な RAM 権限が付与されていること。AccessKey をハードコーディングするのではなく、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET として設定することを推奨します。

リクエストの説明

  • HTTPメソッド：GET
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

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

  • 認証 この操作は、AccessKey ベースの署名（ACS3-HMAC-SHA256 アルゴリズム）を使用する Alibaba Cloud OpenAPI 操作です。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 を含める必要があります。 署名を自分で計算する必要がないよう、Alibaba Cloud SDK または OpenAPI Explorer を使用してこの操作を呼び出すことを推奨します。

リクエストパラメーター

このAPIにはリクエストパラメータはありません。

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

API呼び出しが成功したかどうか：
true：成功
false：失敗

Code

string

レスポンスステータスコード。

Message

string

レスポンスメッセージ。

Data

object

ビジネスデータ。

SubscriptionStartTime

integer

サブスクリプション開始時刻（ミリ秒）

SubscriptionEndTime

integer

サブスクリプション終了時刻（ミリ秒）

Items

Array[Object]

シート情報リスト（specType 別にグループ化）

object

リストデータ

SeatType

string

シートタイプ（specType）
standard - Standard seat
pro - Pro seat
max - Max seat

SeatRefreshTime

integer

現在のサイクルの更新時刻（ミリ秒）

TotalSeats

integer

総シート数

AssignedSeats

integer

割り当て済みシート数

SeatCredits

数値

シートの合計 Credits クォータ

SeatRemainingCredits

数値

現在のサイクルの残り Credits

リクエスト例

この操作では Alibaba Cloud 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: ${SIGNATURE_NONCE}" \
    --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
      }
    ]
  }
}

エラーコード

呼び出しに失敗した場合、エラーメッセージが返されます。その他のエラーコードと解決策については、エラーコードを参照してください。