资产 / 教程 / 配置 API
资产模块(5 接口)
| # | 方法 | 路径 | 说明 |
|---|---|---|---|
| 17 | POST | /api/assets/upload | multipart 上传;限制从 settings 表读取(大小 + 白名单) |
| 18 | GET | /api/assets | 列表(type 筛选 + 关键词 + 分页) |
| 19 | PUT | /api/assets/{id} | 仅重命名(保留原扩展名) |
| 20 | DELETE | /api/assets/{id} | 删除(级联物理删文件) |
| 21 | GET | /upload/{path} | 文件访问(打开/下载,防路径穿越 403) |
分类判定:按扩展名 → 文档(pdf/docx/xlsx/pptx/txt/md)/ 图片(png/jpg/jpeg/webp/gif)/ 音视频(mp3/wav/m4a/mp4/webm/mov)。
教程模块(5 接口)
| # | 方法 | 路径 | 说明 |
|---|---|---|---|
| 22 | GET | /api/tutorials | 列表(标题/摘要/标签/时间,不含 content) |
| 23 | GET | /api/tutorials/{id} | 详情(含 Markdown content) |
| 24 | POST | /api/tutorials | 发布(直接发布,无草稿态) |
| 25 | PUT | /api/tutorials/{id} | 编辑保存 |
| 26 | DELETE | /api/tutorials/{id} | 删除 |
初始内容:启动时 tutorials 表为空 → 自动导入
doc/*.md全部文档(不过滤)。
配置模块(2 接口)
| # | 方法 | 路径 | 说明 |
|---|---|---|---|
| 27 | GET | /api/settings | 返回全部配置 + sensitive_keys 列表 |
| 28 | PUT | /api/settings | 批量保存 → 写表 → 刷新缓存立即生效 |
校验规则:
- 数值字段(超时/轮询/大小限制)必须为数字且 >0,否则 422;
upload_allow_ext非空、逗号分隔;- 敏感字段(
llm_api_key/t2i_token/i2v_token/tts_password)由前端掩码控制显隐。
生效范围:生成管线下次调用即用新参数;资产上传限制即时生效;进行中任务按创建时快照执行。