> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar fatura

## Cabeçalhos da solicitação

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Informações da resposta

<ParamField query="cycleType" type="string" required={true}>
  Granularidade do ciclo de cobrança. Opções:

  * `Hour`: por hora
  * `Day`: por dia
  * `Week`: por semana
  * `Month`: por mês
</ParamField>

<ParamField query="productCategory" type="string" required={true}>
  Tipo de produto. Opções:

  * `summary`: fatura consolidada
  * `llm`: modelo de linguagem grande
</ParamField>

<ParamField query="productName" type="string" required={false}>
  Nome do produto. Suporta correspondência aproximada.
</ParamField>

<ParamField query="startTime" type="string" required={false}>
  Hora de início do ciclo de faturamento a consultar, timestamp (segundos), valor padrão: 0.
</ParamField>

<ParamField query="endTime" type="string" required={false}>
  Hora de término do ciclo de faturamento a consultar, timestamp (segundos), valor padrão: 0.
</ParamField>

<ParamField query="ownerId" type="string" required={false}>
  Especifica o ID da instância a ser consultada.
</ParamField>

## Parâmetros das informações de resposta

<ResponseField name="bills" type="object[]" required={true}>
  Informações de cobrança de instâncias sob demanda.

  <Expandable title="Propriedades" defaultOpen={true}>
    <ResponseField name="userId" type="string" required={true}>
      ID do usuário ao qual a instância pertence.
    </ResponseField>

    <ResponseField name="startTime" type="string" required={true}>
      Hora de início da fatura. O formato é timestamp Unix.
    </ResponseField>

    <ResponseField name="endTime" type="string" required={true}>
      Hora de término da fatura. O formato é timestamp Unix.
    </ResponseField>

    <ResponseField name="billingMethod" type="string" required={true}>
      Método de cobrança da instância. O valor 1 indica cobrança sob demanda.
    </ResponseField>

    <ResponseField name="productName" type="string" required={true}>
      Nome do produto.
    </ResponseField>

    <ResponseField name="category" type="string" required={true}>
      Categoria do produto.
    </ResponseField>

    <ResponseField name="ownerID" type="string" required={true}>
      ID da instância.
    </ResponseField>

    <ResponseField name="billNum0" type="string" required={true}>
      * llm: tokens de entrada
    </ResponseField>

    <ResponseField name="billNum1" type="string" required={true}>
      * llm: tokens de saída
    </ResponseField>

    <ResponseField name="basePrice0" type="string" required={true}>
      Preço original
    </ResponseField>

    <ResponseField name="basePrice1" type="string" required={true}>
      Sem significado
    </ResponseField>

    <ResponseField name="discountPrice0" type="string" required={true}>
      * llm: preço unitário dos tokens de entrada
      * Outros: preço unitário
    </ResponseField>

    <ResponseField name="discountPrice1" type="string" required={true}>
      * llm: preço unitário dos tokens de saída
    </ResponseField>

    <ResponseField name="amount" type="string" required={true}>
      Preço total.
    </ResponseField>

    <ResponseField name="voucherAmount" type="string" required={true}>
      Valor deduzido por voucher.
    </ResponseField>

    <ResponseField name="payAmount" type="string" required={true}>
      Valor pago em dinheiro.
    </ResponseField>

    <ResponseField name="payAmountDisplay" type="string" required={true} />

    <ResponseField name="pricePrecision" type="string" required={true}>
      Precisão do preço.
    </ResponseField>

    <ResponseField name="productId" type="string" required={true}>
      ID do produto.
    </ResponseField>
  </Expandable>
</ResponseField>