# 上传文件

**方法**: `POST`
**路径**: `/v1/files`

上传可跨各种端点/功能使用的文件
单个文件的大小最大为 20MB
仅返回 url， 不支持预训练等
上传有审核，严禁违规内容，一经发现，直接封号

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 multipart/form-data

```text
file
file
必需
要上传的
JSONL
文件的名称。
如果
purpose
设置为“微调”，则每一行都是一个 JSON 记录，其中包含代表您的
训练示例
的“提示”和“完成”字段。
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v1/files' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'file=@""'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
id
string
必需
object
string
必需
bytes
integer
必需
created_at
integer
必需
filename
string
必需
```

#### 示例

```json
{
    "id": "file-BK7bzQj3FfZFXr7DbL6xJwfo",
    "object": "file",
    "bytes": 120000,
    "created_at": 1677610602,
    "filename": "mydata.jsonl",
    "url": "https://cdn.gptbest.vip/file/cdn/20240731/dhLR1YlDyY0hdsuG1cGTGtJmwtwrvA.png"
}
```