Skip to main content

GetBillingOverview

Consulta información general de facturación para un mes especificado, con soporte para agrupación por dimensiones y filtrado.

Sintaxis de la solicitud 

GET /modelstudio/billing/overview HTTP/1.1

Parámetros de solicitud

Name

Tipo

Obligatorio

Descripción

Ejemplo

billMonth

string

Sí

Mes de facturación en formato AAAA-MM. Este campo es obligatorio.

2026-08

groupBy

array<object>

Sí

Lista de condiciones de agrupación. Actualmente, se debe especificar exactamente una dimensión de agrupación. Consulte las notas complementarias a continuación para ver los códigos de dimensión admitidos.

groupBy.code

string

Sí

Código de dimensión.

MAAS_TYPE

filter

object

No

Condiciones de filtro.

filter.dimensions

array<object>

No

Lista de dimensiones de filtro.

filter.dimensions.code

string

No

Código de dimensión.

BASE_MODEL

filter.dimensions.values

array<string>

No

Lista de valores de filtro.

["qwen-max"]

filter.dimensions.selectType

string

No

Tipo de filtro. Valores válidos:

  • IN

  • NOT

IN

topNum

integer

No

Número de grupos a devolver. Rango válido: de 1 a 20. Valor predeterminado: 20.

20

zeroFilter

boolean

No

Indica si se deben filtrar los grupos con monto cero. Valor predeterminado: true.

true

regionId

string

No

ID de región.

cn-beijing

locale

string

No

Idioma de la respuesta. Valor predeterminado: en-US. Valores válidos:

  • en-US: Inglés

  • zh-CN: Chino

zh-CN

Notas complementarias Se admiten los siguientes valores para groupBy[].code y filter.dimensions[].code. Se recomienda usar mayúsculas de forma consistente:

Código de dimensión

Descripción

filter.dimensions[].values válidos

MAAS_TYPE

Tipo de negocio MaaS

inference (inferencia de modelo), training (entrenamiento de modelo), model_units (unidades de modelo), capacity_reserved (capacidad reservada)

BASE_MODEL

Modelo base

Valores originales del modelo base procedentes de los datos de facturación, como qwen-plus

API_KEY_ID

ID de clave de API

Valores originales de ID de clave de API de los datos de facturación

WORKSPACE_ID

ID de espacio de trabajo

Valores originales de ID de espacio de trabajo de los datos de facturación

FEE_TYPE

Tipo de tarifa

billing (tarifas de facturación), subscription (tarifas de suscripción)

CHARGE_TYPE

Método de facturación

postpaid (pago por uso), prepaid (suscripción)

BUSINESS_REGION

Región de negocio

cn-beijing, ap-southeast-1, cn-hongkong, etc. Los valores se basan en datos reales

SERVICE_SITE

Sitio de servicio

asia-pacific-china, global, international, etc. Los valores se basan en datos reales

ARTICLE_CODE

Código de artículo

sfm_inferenceglobal_public_intl, etc. Los valores se basan en datos reales

Puede pasar DIMENSION_FILTER_NULL_VALUE en filter.dimensions[].values para cualquier dimensión a fin de coincidir con registros donde el campo sea NULL o una cadena vacía.

Parámetros de respuesta

Name

Tipo

Descripción

Ejemplo

requestId

string

ID de solicitud.

BB521414-5D38-5E66-AA66-963B2B4200E2

code

string

Código de respuesta.

200

message

string

Mensaje de respuesta.

null

success

boolean

Indica si la solicitud se realizó correctamente.

true

data

object

Datos generales de facturación.

data.currency

string

Moneda del importe.

USD

data.totalAmount

string

Importe total.

31228.60

data.pretaxAmount

string

Importe total sin impuestos.

28729.32

data.taxAmount

string

Importe total de impuestos.

2499.28

data.groups

array<object>

Lista de grupos TopN ordenada por monto en orden descendente.

data.groups.key

string

Valor de dimensión del grupo. Los valores Null devuelven DIMENSION_FILTER_NULL_VALUE.

inferencia

data.groups.name

string

Nombre para mostrar del grupo, afectado por el parámetro locale. Los valores Null se muestran como -.

Inferencia de modelos

data.groups.articleCodes

array<string>

Lista de códigos de artículo involucrados en este grupo.

data.groups.amount

string

Importe para este grupo.

3000

data.groups.percentage

string

Proporción del monto del grupo respecto al monto total TopN.

0.10

Ejemplos

Respuesta de éxito de ejemplo Formato JSON 
{
  "requestId": "BB521414-5D38-5E66-AA66-963B2B4200E2",
  "code": "200",
  "message": "null",
  "success": true,
  "data": {
    "currency": "USD",
    "totalAmount": "31228.60",
    "pretaxAmount": "28729.32",
    "taxAmount": "2499.28",
    "groups": [
      {
        "key": "inference",
        "name": "Model Inference",
        "articleCodes": [
          "sfm_inferenceglobal_public_intl"
        ],
        "amount": "3000",
        "percentage": "0.10"
      }
    ]
  }
}