Consulta informações gerais de faturamento para um mês especificado, com suporte para agrupamento por dimensões e filtragem.
Sintaxe da solicitação
Parâmetros da solicitação
Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| billMonth | string | Sim | Mês de faturamento no formato AAAA-MM. Este campo é obrigatório. | 2026-08 |
| groupBy | array<object> | Sim | Lista de condições de agrupamento. Atualmente, exatamente uma dimensão de agrupamento deve ser especificada. 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. | |
| 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. | 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. | BB521414-5D38-5E66-AA66-963B2B4200E2 |
| 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 gerais de faturamento. | |
| data.currency | string | Moeda do valor. | USD |
| data.totalAmount | string | Valor total. | 31228.60 |
| data.pretaxAmount | string | Valor total excluindo impostos. | 28729.32 |
| data.taxAmount | string | Valor total de impostos. | 2499.28 |
| data.groups | array<object> | Lista de grupos TopN ordenada por valor em ordem decrescente. | |
| data.groups.key | string | Valor da dimensão do grupo. Valores Null retornam DIMENSION_FILTER_NULL_VALUE. | inferência |
| data.groups.name | string | Nome de exibição do grupo, afetado pelo parâmetro locale. Valores Null são exibidos como -. | Inferência de Modelo |
| data.groups.articleCodes | array<string> | Lista de códigos de artigos envolvidos neste grupo. | |
| data.groups.amount | string | Valor para este grupo. | 3000 |
| data.groups.percentage | string | Proporção do valor do grupo em relação ao valor total do TopN. | 0.10 |
Exemplos
Exemplo de resposta de sucesso
formato JSON