Skip to main content

GetBillingTrend

Consulta información de tendencias de facturación para un rango de tiempo especificado, con soporte para agregación diaria o mensual, agrupación por dimensiones y filtrado.

Sintaxis de la solicitud 

GET /modelstudio/billing/trend HTTP/1.1

Parámetros de solicitud

Name

Tipo

Obligatorio

Descripción

Ejemplo

granularity

string

Sí

Granularidad de consulta. Este campo es obligatorio. Valores válidos:

  • MONTH: mensual

  • DAY: diario

DAY

timePeriod

object

Sí

Rango de tiempo de consulta, incluidas las horas de inicio y finalización. Este campo es obligatorio.

timePeriod.start

string

Sí

Hora de inicio en formato AAAA-MM-DD.

2026-08-01

timePeriod.end

string

Sí

Hora de finalización en formato AAAA-MM-DD.

2026-08-31

groupBy

array<object>

Sí

Condición de agrupación. Se debe especificar exactamente un elemento. 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 de dimensión.

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. Los grupos restantes se fusionan en "Otros".

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.

099A671E-FA21-5A36-8A73-918572DDEF53

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 de respuesta.

data.costTotals

object

Costo total para todo el rango de tiempo de consulta, incluidos TopN y "Otros".

data.costTotals.amount

string

Monto total del costo.

100

data.costTotals.pretaxAmount

string

Monto sin impuestos.

94.34

data.costTotals.taxAmount

string

Monto de impuestos.

5.66

data.costTotals.currency

string

Moneda del importe.

CNY

data.groupByTotal

array<object>

Costo total para los grupos TopN y el grupo opcional "Otros" dentro del periodo.

data.groupByTotal.key

string

Valor de dimensión del grupo.

qwen-plus

data.groupByTotal.name

string

Nombre para mostrar del grupo, afectado por el parámetro locale.

qwen-plus

data.groupByTotal.amount

string

Monto total para este grupo.

60

data.groupByTotal.pretaxAmount

string

Monto sin impuestos para este grupo.

56.60

data.groupByTotal.taxAmount

string

Monto de impuestos para este grupo.

3.40

data.resultByTime

array<object>

Lista de tendencias de costos ordenada por hora en orden ascendente.

data.resultByTime.period

string

Periodo estadístico. DAY devuelve aaaammdd, MONTH devuelve aaaamm.

20260801

data.resultByTime.total

object

Costo total para el periodo actual.

data.resultByTime.total.amount

string

Monto total del costo para el periodo actual.

30

data.resultByTime.total.pretaxAmount

string

Monto sin impuestos para el periodo actual.

28.30

data.resultByTime.total.taxAmount

string

Monto de impuestos para el periodo actual.

1.70

data.resultByTime.total.currency

string

Moneda del monto para el periodo actual.

CNY

data.resultByTime.periodDetails

array<object>

Grupos de costos que existen realmente en el periodo actual.

data.resultByTime.periodDetails.key

string

Valor de dimensión del grupo. Los datos fuera de TopN usan DIMENSION_GROUP_OTHERS_VALUE.

qwen-plus

data.resultByTime.periodDetails.name

string

Nombre para mostrar del grupo, afectado por el parámetro locale.

qwen-plus

data.resultByTime.periodDetails.amount

string

Monto para este grupo en el periodo actual.

20

data.resultByTime.periodDetails.pretaxAmount

string

Monto sin impuestos para este grupo en el periodo actual.

18.87

data.resultByTime.periodDetails.taxAmount

string

Monto de impuestos para este grupo en el periodo actual.

1.13

data.resultByTime.periodDetails.percentage

string

Proporción del monto de este grupo respecto al monto total del periodo actual.

0.6667

Ejemplos

Respuesta de éxito de ejemplo Formato JSON 
{
  "requestId": "099A671E-FA21-5A36-8A73-918572DDEF53",
  "code": "200",
  "message": "null",
  "success": true,
  "data": {
    "costTotals": {
      "amount": "100",
      "pretaxAmount": "94.34",
      "taxAmount": "5.66",
      "currency": "CNY"
    },
    "groupByTotal": [
      {
        "key": "qwen-plus",
        "name": "qwen-plus",
        "amount": "60",
        "pretaxAmount": "56.60",
        "taxAmount": "3.40"
      }
    ],
    "resultByTime": [
      {
        "period": "20260801",
        "total": {
          "amount": "30",
          "pretaxAmount": "28.30",
          "taxAmount": "1.70",
          "currency": "CNY"
        },
        "periodDetails": [
          {
            "key": "qwen-plus",
            "name": "qwen-plus",
            "amount": "20",
            "pretaxAmount": "18.87",
            "taxAmount": "1.13",
            "percentage": "0.6667"
          }
        ]
      }
    ]
  }
}