---
title: "上传文件"
method: POST
path: "/paas/v4/files"
tags: ["文件 API"]
---

# 上传文件

`POST /paas/v4/files`

上传用于 `Batch 任务`、`智能体` 等功能的文件。注意 `Try it` 功能仅支持小文件上传，实际支持的文件大小请参见下文 `purpose` 相关说明。点击 **Try it** 按钮可快速试用。

## Response `200`

业务处理成功

- FileObject
  - `id` string — 文件标识符
  - `object` 'file'
  - `bytes` integer — 文件大小（字节）
  - `created_at` integer — 文件创建的`Unix`时间戳
  - `filename` string — 文件名
  - `purpose` string — 文件的预期用途

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)