Alibaba Cloud Model Studio:Obtener estadísticas de asientos y créditos de suscripción

Consulta las estadísticas de asientos y créditos de suscripción, incluido el período de suscripción, recuento de asientos por tipo, asientos asignados y créditos restantes.

Requisitos previos

Ha obtenido la AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han otorgado los permisos RAM necesarios para invocar esta operación. Le recomendamos que configure la AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarla directamente.

Descripción de la solicitud

• Método HTTP: GET

• URL de solicitud

  Región	Endpoint
  Singapur	GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats

• Autenticación

  Esta operación es una operación de OpenAPI de Alibaba Cloud que utiliza firmas basadas en AccessKey (el algoritmo ACS3-HMAC-SHA256). No se admite el esquema Authorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunes x-acs-action: GetSubscriptionStats, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce y Authorization.

  Le recomendamos que invoque esta operación con un SDK de Alibaba Cloud o OpenAPI Explorer para no tener que calcular la firma usted mismo.

Parámetros de solicitud

Esta API no tiene parámetros de solicitud.

Parámetros de respuesta

Parámetro	Tipo	Descripción
Success	boolean	Indica si la llamada a la API fue exitosa: true: éxito false: fallo
Code	string	Código de estado de la respuesta.
Message	string	Mensaje de respuesta.
Data	object	Datos comerciales.
SubscriptionStartTime	integer	Hora de inicio de la suscripción, en milisegundos
SubscriptionEndTime	integer	Hora de finalización de la suscripción, en milisegundos
Items	Array[Object]	Lista de información de asientos (agrupada por specType)
	object	Datos de lista
SeatType	string	Tipo de asiento (specType) standard - Asiento estándar pro - Asiento Pro max - Asiento Max
SeatRefreshTime	integer	Hora de actualización del ciclo actual, en milisegundos
TotalSeats	integer	Número total de asientos
AssignedSeats	integer	Número de asientos asignados
SeatCredits	number	Cuota total de Credits de asientos
SeatRemainingCredits	number	Credits restantes para el ciclo actual

Ejemplo de solicitud

Esta operación utiliza firmas de OpenAPI de Alibaba Cloud. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo ACS3-HMAC-SHA256, y x-acs-date y x-acs-signature-nonce deben reemplazarse con valores reales.

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

Ejemplo de respuesta

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

Códigos de error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error.