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

# 查询账单

## 请求头

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 秘钥}}。
</ParamField>

## 响应信息

<ParamField query="cycleType" type="string" required={true}>
  计费周期粒度。选项：

  * `Hour`：按小时
  * `Day`: 按天
  * `Week`：按周
  * `Month`：按月
</ParamField>

<ParamField query="productCategory" type="string" required={true}>
  产品类型。选项：

  * `summary`：汇总账单
  * `llm`： 大语言模型
</ParamField>

<ParamField query="productName" type="string" required={false}>
  产品名称。支持模糊匹配。
</ParamField>

<ParamField query="startTime" type="string" required={false}>
  查询账单周期的开始时间，时间戳（秒），默认值：0。
</ParamField>

<ParamField query="endTime" type="string" required={false}>
  查询账单周期的结束时间，时间戳（秒），默认值：0。
</ParamField>

<ParamField query="ownerId" type="string" required={false}>
  指定要查询的实例 ID。
</ParamField>

## 响应信息参数

<ResponseField name="bills" type="object[]" required={true}>
  按需实例计费信息。

  <Expandable title="属性" defaultOpen={true}>
    <ResponseField name="userId" type="string" required={true}>
      实例所属的用户 ID。
    </ResponseField>

    <ResponseField name="startTime" type="string" required={true}>
      账单的开始时间。格式为 Unix 时间戳。
    </ResponseField>

    <ResponseField name="endTime" type="string" required={true}>
      账单的结束时间。格式为 Unix 时间戳。
    </ResponseField>

    <ResponseField name="billingMethod" type="string" required={true}>
      实例的计费方式。值为 1 表示按需计费。
    </ResponseField>

    <ResponseField name="productName" type="string" required={true}>
      产品名称。
    </ResponseField>

    <ResponseField name="category" type="string" required={true}>
      产品类别。
    </ResponseField>

    <ResponseField name="ownerID" type="string" required={true}>
      实例 ID。
    </ResponseField>

    <ResponseField name="billNum0" type="string" required={true}>
      * llm：输入 tokens
    </ResponseField>

    <ResponseField name="billNum1" type="string" required={true}>
      * llm：输出 tokens
    </ResponseField>

    <ResponseField name="basePrice0" type="string" required={true}>
      原价
    </ResponseField>

    <ResponseField name="basePrice1" type="string" required={true}>
      无意义
    </ResponseField>

    <ResponseField name="discountPrice0" type="string" required={true}>
      * llm：输入 tokens 单价
      * 其他：单价
    </ResponseField>

    <ResponseField name="discountPrice1" type="string" required={true}>
      * llm：输出 tokens 单价
    </ResponseField>

    <ResponseField name="amount" type="string" required={true}>
      总价。
    </ResponseField>

    <ResponseField name="voucherAmount" type="string" required={true}>
      代金券扣除金额。
    </ResponseField>

    <ResponseField name="payAmount" type="string" required={true}>
      现金支付金额。
    </ResponseField>

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

    <ResponseField name="pricePrecision" type="string" required={true}>
      价格精度。
    </ResponseField>

    <ResponseField name="productId" type="string" required={true}>
      产品 ID。
    </ResponseField>
  </Expandable>
</ResponseField>