Skip to main content

GetBillingOverview

Consulta informações gerais de faturamento para um mês especificado, com suporte para agrupamento por dimensões e filtragem.

Sintaxe da solicitação

GET /modelstudio/billing/overview HTTP/1.1

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

  • NOT

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:

  • 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.

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
{
  "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"
      }
    ]
  }
}