跳转到主要内容
POST
上传流水线文件

授权

Authorization
string
header
必填

每个请求都通过 API 密钥认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API 密钥,知识库接口使用知识库 API 密钥(快速开始)。

API 密钥应保存在服务端,切勿嵌入客户端代码。缺失或无效的密钥会返回 HTTP 401(unauthorized)。

请求体

multipart/form-data
file
file
必填

要上传的文件,放在一个 multipart/form-data 部分中发送。文件名不能包含 / 或 \。

扩展名不受限制,列入部署安全黑名单(UPLOAD_FILE_EXTENSION_BLACKLIST,默认为空)的除外。

各类文件的默认大小上限:图片 5 MB(使用 Docker Compose 部署时为 10 MB)、音频 50 MB、视频 100 MB、其他文件 15 MB。平台管理员可通过 UPLOAD_*_FILE_SIZE_LIMIT 环境变量 调整这些上限。

响应

文件上传成功。

id
string

已上传文件的唯一标识符。

name
string

原始文件名。

size
integer

文件大小(字节)。

extension
string

文件扩展名。

mime_type
string

文件的 MIME 类型。

created_by
string

上传文件的用户 ID。

created_at
string

上传时间戳(ISO 8601 格式)。