1. 线路1
小影API
  • 音乐
    • 线路1
      • 搜索音乐
      • 首页推荐
      • 获取歌手信息
      • 获取播放音乐信息
    • 线路2
      • 首页热门搜索
      • 搜索音乐
      • 获取音乐播放信息
  • 翻译
    • 线路1
      • 支持的语言列表
      • 文本翻译 (有道翻译 AI 引擎 - line1 版)
  • 文件上传
    • 线路1
      • 文件上传接口
        POST
      • 文件下载接口
        GET
  • 插件广场
    • 插件管理
      • 插件列表
      • 创建插件
      • 插件详情
      • 更新插件
      • 删除插件
    • 版本管理
      • 版本列表
      • 添加版本
      • 更新版本
      • 删除版本
    • 图片管理
      • 添加图片
      • 删除图片
    • 视频管理
      • 添加视频
      • 删除视频
  1. 线路1

文件上传接口

POST
/api/file/line1/upload/
--- 文件上传接口 ---
请求方式: POST (multipart/form-data)
请求参数:
file (File, 必填) 上传的文件,单文件
响应格式:
{
"code": 10000,
"message": "成功",
"data": {
"name": "example.jpg",
"size": 102400,
"size_display": "100.00 KB",
"type": "image/jpeg",
"ext": ".jpg",
"is_image": true,
"url": "/media/uploads/xxx.jpg",
"download_url": "/api/file/line1/download/uploads/xxx.jpg/",
"saved_name": "xxx.jpg"
}
}
错误码:
20001 参数缺失(未上传文件)
20003 参数值非法(文件类型不允许 / 文件大小超限)
50001 服务器内部错误(文件保存失败)
使用示例 (curl):
curl -X POST http://127.0.0.1:8000/api/file/line1/upload/
-F "file=@/path/to/example.jpg"

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/file/line1/upload/' \
--form 'file=@""'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 10000,
    "message": "成功",
    "data": {
        "name": "屏幕截图 2026-05-26 215402.png",
        "size": 23770,
        "size_display": "23.21 KB",
        "type": "image/png",
        "ext": ".png",
        "is_image": true,
        "url": "/media/uploads/185a65a974d140b19864769d257643de.png",
        "download_url": "/api/file/line1/download/uploads/185a65a974d140b19864769d257643de.png/",
        "saved_name": "185a65a974d140b19864769d257643de.png"
    }
}
修改于 2026-06-05 04:25:52
上一页
线路1
下一页
文件下载接口
Built with