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

## 请求体

<ParamField body="file" type="file" required={true}>
  上传的文件应为批处理输入文件，格式为 `.jsonl`，其中每行描述一个 API 推理请求的详细信息。

  每个请求必须包含一个唯一的 `custom_id`，以便在批处理完成后在输出文件中查找相应的推理结果。每行的 `body` 字段中的参数将作为实际推理请求参数发送到指定的 endpoint。

  <Warning>
    单个 JSONL 文件中的所有请求必须使用同一个模型，请不要在一个批次中混合不同模型的请求。
  </Warning>

  以下是包含两个请求的示例输入文件：

  ```JSON theme={null}
  {"custom_id": "request-1", "body": {"model": "deepseek/deepseek-v3-0324", "messages": [{"role": "user", "content": "Hello, world!"}], "max_tokens": 400}}
  {"custom_id": "request-2", "body": {"model": "deepseek/deepseek-v3-0324", "messages": [{"role": "system", "content": "You are a helpful assistant."},{"role": "user", "content": "Hello world!"}],"max_tokens": 1000}}
  ```
</ParamField>

<ParamField body="purpose" type="string" required={true}>
  上传文件的用途。用于批处理时，应设置为 `batch`。

  枚举值: `batch`
</ParamField>

## 响应

<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="created_at" type="integer" required={true}>
  文件创建时的 Unix 时间戳（秒）。
</ResponseField>

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

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

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

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