Mendapatkan Statistik Kursi dan Kredit Langganan

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil operasi ini. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya.

Deskripsi permintaan

Metode HTTP: GET
URL Permintaan
Wilayah
Endpoint
Singapura
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats
Autentikasi Operasi ini adalah operasi Alibaba Cloud OpenAPI yang menggunakan tanda tangan berbasis AccessKey (algoritma ACS3-HMAC-SHA256). Skema Authorization: Bearer {API_KEY} tidak didukung. Permintaan harus menyertakan header umum x-acs-action: GetSubscriptionStats, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, dan Authorization. Kami menyarankan Anda memanggil operasi ini dengan Alibaba Cloud SDK atau OpenAPI Explorer sehingga Anda tidak perlu menghitung tanda tangan sendiri.

Wilayah	Endpoint
Singapura	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats`

Parameter permintaan

API ini tidak memiliki parameter permintaan.

Parameter respons

Parameter	Tipe	Deskripsi
Success	boolean	Apakah panggilan API berhasil: true: berhasil false: gagal
Code	string	Kode status respons.
Message	string	Pesan respons.
Data	object	Data bisnis.
SubscriptionStartTime	integer	Waktu mulai langganan, milidetik
SubscriptionEndTime	integer	Waktu berakhir langganan, milidetik
Items	Array[Object]	Daftar informasi kursi (dikelompokkan berdasarkan specType)
	object	Data daftar
SeatType	string	Jenis kursi (specType) standard - Kursi Standard pro - Kursi Pro max - Kursi Max
SeatRefreshTime	integer	Waktu penyegaran siklus saat ini, milidetik
TotalSeats	integer	Total jumlah kursi
AssignedSeats	integer	Jumlah kursi yang ditugaskan
SeatCredits	angka	Total kuota Credits kursi
SeatRemainingCredits	angka	Sisa Credits siklus saat ini

Contoh permintaan

Operasi ini menggunakan tanda tangan Alibaba Cloud OpenAPI. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma ACS3-HMAC-SHA256, dan x-acs-date serta x-acs-signature-nonce harus diganti dengan nilai aktual.

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}"

Contoh respons

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

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan.

​Prasyarat

​Deskripsi permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons