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
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:
| 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 |
| 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:
| zh-CN |
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 |
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