上传文件

POST

/files

上传可跨各种端点使用的文件。单个文件的最大大小可达 512 MB，一个组织上传的所有文件的大小最大可达 1 TB。

助手 API 支持多达 200 万个令牌和特定文件类型的文件。有关详细信息，请参阅助手工具指南。

微调 API 仅支持 .jsonl 文件。输入还具有微调聊天或完成模型所需的某些格式。

Batch API 仅支持大小不超过 200 MB 的 .jsonl 文件。输入还具有特定的所需格式。

如果您需要增加这些存储限制，请联系我们。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/files' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'purpose="fine-tune"'

响应示例

{
  "id": "file-abc123",
  "object": "file",
  "bytes": 120000,
  "created_at": 1677610602,
  "expires_at": 1677614202,
  "filename": "mydata.jsonl",
  "purpose": "fine-tune",
}

修改于 2025-09-17 06:24:27

文件对象

列出文件