文件上传

通用文件上传能力:图片/视频/普通文件,白名单校验并存储到本地 /media,返回可访问 URL。

/api/upload/

服务说明

文件上传服务提供图片、视频与通用文件三类上传入口,文件落盘到站点 /media 目录并返回可直接引用的 URL,适合作为业务系统的统一附件通道。

全部接口使用 multipart/form-data,文件字段名固定为 file。服务端按白名单校验扩展名并校验文件头(magic bytes),可内联渲染或执行的文件类型(如 svg、html、脚本)一律拒绝,避免上传文件被当作存储型 XSS 利用。

体积限制:图片最大 20MB,视频与通用文件最大 100MB。本服务需项目签名。

本地文件上传

本地存储(/media/uploads/…) 需签名

全部使用 multipart/form-data,文件字段固定为 file;仅支持白名单类型并校验文件头(防伪装/防脚本上传)。

POST /api/upload/image 累计调用 2 次

上传图片

上传图片,返回可直接引用的图片 URL。

multipart/form-data 文件字段 file:直接用下方“选择文件”上传即可。

  • 支持类型:jpg/jpeg/png/gif/bmp/webp/ico/tiff;最大 20MB。
  • svg 因可内嵌脚本已禁用。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 为站点媒体访问地址(/media/...),可直接引用。
POST /api/upload/video 累计调用 0 次

上传视频

上传视频文件。

multipart/form-data 文件字段 file:直接用下方“选择文件”上传即可。

  • 最大 100MB;返回 type=video。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 为站点媒体访问地址(/media/...),可直接引用。
POST /api/upload/file 累计调用 3 次

上传通用文件

上传通用文件(白名单:zip/pdf/docx/xlsx/txt 等)。

multipart/form-data 文件字段 file:直接用下方“选择文件”上传即可。

  • 最大 100MB;白名单制并校验文件头;返回 type=file。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 为站点媒体访问地址(/media/...),可直接引用。
小影API · 通用 API 聚合服务