Skip to main content

GetBillingTrend

Consulta informações de tendência de faturamento para um intervalo de tempo especificado, com suporte para agregação diária ou mensal, agrupamento por dimensões e filtragem.

Sintaxe da solicitação

GET /modelstudio/billing/trend HTTP/1.1

Parâmetros da solicitação

Nome

Tipo

Obrigatório

Descrição

Exemplo

granularity

string

Sim

Granularidade da consulta. Este campo é obrigatório. Valores válidos:

  • MONTH: mensal

  • DAY: diário

DAY

timePeriod

object

Sim

Intervalo de tempo da consulta, incluindo horários de início e término. Este campo é obrigatório.

timePeriod.start

string

Sim

Hora de início no formato AAAA-MM-DD.

2026-08-01

timePeriod.end

string

Sim

Hora de término no formato AAAA-MM-DD.

2026-08-31

groupBy

array<object>

Sim

Condição de agrupamento. Exatamente um elemento deve ser especificado. Consulte as notas suplementares abaixo para os códigos de dimensão suportados.

groupBy.code

string

Sim

Código da dimensão.

MAAS_TYPE

filter

object

Não

Condições de filtro de dimensão.

filter.dimensions

array<object>

Não

Lista de dimensões de filtro.

filter.dimensions.code

string

Não

Código da dimensão.

BASE_MODEL

filter.dimensions.values

array<string>

Não

Lista de valores de filtro.

["qwen-max"]

filter.dimensions.selectType

string

Não

Tipo de filtro. Valores válidos:

  • IN

  • NOT

IN

topNum

integer

Não

Número de grupos a serem retornados. Intervalo válido: 1 a 20. Valor padrão: 20. Os grupos restantes são mesclados em "Other".

20

zeroFilter

boolean

Não

Se deve filtrar grupos com valor zero. Valor padrão: true.

true

regionId

string

Não

ID da região.

cn-beijing

locale

string

Não

Idioma da resposta. Valor padrão: en-US. Valores válidos:

  • en-US: Inglês

  • zh-CN: Chinês

zh-CN

Notas suplementares Os seguintes valores são suportados para groupBy[].code e filter.dimensions[].code. Recomendamos usar letras maiúsculas consistentemente:

Código da dimensão

Descrição

filter.dimensions[].values válidos

MAAS_TYPE

Tipo de negócio MaaS

inference (inferência de modelo), training (treinamento de modelo), model_units (unidades de modelo), capacity_reserved (capacidade reservada)

BASE_MODEL

Modelo base

Valores originais do modelo base dos dados de faturamento, como qwen-plus

API_KEY_ID

ID da Chave de API

Valores originais de ID da Chave de API dos dados de faturamento

WORKSPACE_ID

ID do Workspace

Valores originais de Workspace ID dos dados de faturamento

FEE_TYPE

Tipo de taxa

billing (taxas de faturamento), subscription (taxas de assinatura)

CHARGE_TYPE

Método de cobrança

postpaid (pago conforme o uso), prepaid (assinatura)

BUSINESS_REGION

Região de negócios

cn-beijing, ap-southeast-1, cn-hongkong, etc. Os valores são baseados em dados reais

SERVICE_SITE

Site do serviço

asia-pacific-china, global, international, etc. Os valores são baseados em dados reais

ARTICLE_CODE

Código do artigo

sfm_inferenceglobal_public_intl, etc. Os valores são baseados em dados reais

Você pode passar DIMENSION_FILTER_NULL_VALUE em filter.dimensions[].values para qualquer dimensão para corresponder a registros onde o campo é NULL ou uma string vazia.

Parâmetros de resposta

Nome

Tipo

Descrição

Exemplo

requestId

string

ID da solicitação.

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

code

string

Código de resposta.

200

message

string

Mensagem de resposta.

null

success

boolean

Se a solicitação foi bem-sucedida.

true

data

object

Dados da resposta.

data.costTotals

object

Custo total para todo o intervalo de tempo da consulta, incluindo TopN e "Other".

data.costTotals.amount

string

Valor total do custo.

100

data.costTotals.pretaxAmount

string

Valor sem impostos.

94.34

data.costTotals.taxAmount

string

Valor do imposto.

5.66

data.costTotals.currency

string

Moeda do valor.

CNY

data.groupByTotal

array<object>

Custo total para grupos TopN e o grupo opcional "Other" dentro do período.

data.groupByTotal.key

string

Valor da dimensão do grupo.

qwen-plus

data.groupByTotal.name

string

Nome de exibição do grupo, afetado pelo parâmetro locale.

qwen-plus

data.groupByTotal.amount

string

Valor total para este grupo.

60

data.groupByTotal.pretaxAmount

string

Valor sem impostos para este grupo.

56.60

data.groupByTotal.taxAmount

string

Valor do imposto para este grupo.

3.40

data.resultByTime

array<object>

Lista de tendências de custo ordenada por tempo em ordem crescente.

data.resultByTime.period

string

Período estatístico. DAY retorna aaaammdd, MONTH retorna aaaamm.

20260801

data.resultByTime.total

object

Custo total para o período atual.

data.resultByTime.total.amount

string

Valor total do custo para o período atual.

30

data.resultByTime.total.pretaxAmount

string

Valor sem impostos para o período atual.

28.30

data.resultByTime.total.taxAmount

string

Valor do imposto para o período atual.

1.70

data.resultByTime.total.currency

string

Moeda do valor para o período atual.

CNY

data.resultByTime.periodDetails

array<object>

Grupos de custo que realmente existem no período atual.

data.resultByTime.periodDetails.key

string

Valor da dimensão do grupo. Dados fora do TopN usam DIMENSION_GROUP_OTHERS_VALUE.

qwen-plus

data.resultByTime.periodDetails.name

string

Nome de exibição do grupo, afetado pelo parâmetro locale.

qwen-plus

data.resultByTime.periodDetails.amount

string

Valor para este grupo no período atual.

20

data.resultByTime.periodDetails.pretaxAmount

string

Valor sem impostos para este grupo no período atual.

18.87

data.resultByTime.periodDetails.taxAmount

string

Valor do imposto para este grupo no período atual.

1.13

data.resultByTime.periodDetails.percentage

string

Proporção do valor deste grupo em relação ao valor total do período atual.

0.6667

Exemplos

Exemplo de resposta de sucesso 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"
          }
        ]
      }
    ]
  }
}