跳转到主要内容
POST
cURL

授权

Authorization
string
header
必填

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

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

请求体

multipart/form-data

文件上传请求。需要 multipart/form-data 格式。

file
file
必填

要上传的文件,作为 multipart/form-data 的一个部分。文件名不能包含 /\

除部署安全黑名单(UPLOAD_FILE_EXTENSION_BLACKLIST,默认为空)中的扩展名外,任何文件类型都可上传。

文件大小按类别限制:图片 10 MB、音频 50 MB、视频 100 MB、其他文件 15 MB(默认值),可通过 UPLOAD_*_FILE_SIZE_LIMIT 环境变量 调整。

user
string

该上传所属的终端用户标识,由你的应用定义,需在应用内唯一。省略时上传归属于共享的 DEFAULT-USER。只有携带相同 user 的后续请求才能引用该文件。参见 终端用户身份

响应

文件上传成功。

id
string<uuid>

唯一文件 ID。

name
string

文件名。

size
integer

文件大小(字节)。

extension
string | null

文件扩展名。

mime_type
string | null

文件的 MIME 类型。

created_by
string<uuid> | null

上传者的终端用户 ID。可通过 获取终端用户信息 查询详情。

created_at
integer<int64>

上传时间戳(Unix 纪元秒)。

preview_url
string | null

文件的预览 URL。

source_url
string

文件的签名下载 URL。

original_url
string | null

文件的原始 URL。

user_id
string<uuid> | null

未使用,始终为 null

tenant_id
string<uuid> | null

关联的租户 ID。

conversation_id
string<uuid> | null

关联的会话 ID。

file_key
string | null

未使用,始终为 null