> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/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>

## 响应

<ResponseField name="code" type="string" required={true}>
  表示请求结果的 HTTP 状态码。
</ResponseField>

<ResponseField name="message" type="string" required={true}>
  关于请求结果的描述信息。
</ResponseField>

<ResponseField name="data" type="array" required={true}>
  文件对象数组。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="id" type="string" required={true}>
      文件的唯一标识符。
    </ResponseField>

    <ResponseField name="object" type="string" required={true}>
      对象类型，恒为 `file`。
    </ResponseField>

    <ResponseField name="bytes" type="integer" required={true}>
      文件大小（字节）。
    </ResponseField>

    <ResponseField name="filename" type="string" required={true}>
      文件名。
    </ResponseField>

    <ResponseField name="created_at" type="integer" required={true}>
      文件创建时的 Unix 时间戳（秒）。
    </ResponseField>

    <ResponseField name="expires_at" type="integer" required={false}>
      文件到期的 Unix 时间戳（秒）。仅对输出文件返回。
    </ResponseField>

    <ResponseField name="purpose" type="string" required={true}>
      文件的用途。

      可用用途：

      * `batch` - 批处理的输入文件
      * `batch_output` - 批处理的输出文件
    </ResponseField>

    <ResponseField name="metadata" type="object" required={true}>
      关于该文件的附加元数据。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="total_requests" type="integer" required={false}>
          批处理输入文件中的请求总数。仅对批处理输入文件返回。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>