POST
/
openai
/
v1
/
files
上传文件
curl --request POST \
  --url https://api.ppinfra.com/openai/v1/files \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "purpose": "<string>"
}'
{
  "id": "<string>",
  "object": "<string>",
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "purpose": "<string>",
  "metadata": {
    "total_requests": 123
  }
}
上传批处理输入文件，以便在创建批处理时能够被正确引用。

​
请求头

​
Content-Type
string
required
枚举值: application/json
​
Authorization
string
required
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
file
file
required
上传的文件应为批处理输入文件，格式为 .jsonl，其中每行描述一个 API 推理请求的详细信息。每个请求必须包含一个唯一的 custom_id，以便在批处理完成后在输出文件中查找相应的推理结果。每行的 body 字段中的参数将作为实际推理请求参数发送到指定的 endpoint。以下是包含两个请求的示例输入文件：
{"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}}
​
purpose
string
required
上传文件的用途。用于批处理时，应设置为 batch。枚举值: batch

​
响应

​
id
string
required
上传文件的唯一标识符。
​
object
string
required
对象类型，恒为 file。
​
bytes
integer
required
上传文件的字节大小。
​
created_at
integer
required
文件创建时的 Unix 时间戳（秒）。
​
filename
string
required
上传文件的名称。
​
purpose
string
required
上传文件的用途。
​
metadata
object
关于上传文件的附加元数据。