🎉 v2.0 已发布:SQLite 数据源 · 认证系统 · 五页面工作台
aivideo.site
v2.0

资产 / 教程 / 配置 API

资产模块(5 接口)

#方法路径说明
17POST/api/assets/uploadmultipart 上传;限制从 settings 表读取(大小 + 白名单)
18GET/api/assets列表(type 筛选 + 关键词 + 分页)
19PUT/api/assets/{id}仅重命名(保留原扩展名)
20DELETE/api/assets/{id}删除(级联物理删文件)
21GET/upload/{path}文件访问(打开/下载,防路径穿越 403)

分类判定:按扩展名 → 文档(pdf/docx/xlsx/pptx/txt/md)/ 图片(png/jpg/jpeg/webp/gif)/ 音视频(mp3/wav/m4a/mp4/webm/mov)。

教程模块(5 接口)

#方法路径说明
22GET/api/tutorials列表(标题/摘要/标签/时间,不含 content)
23GET/api/tutorials/{id}详情(含 Markdown content)
24POST/api/tutorials发布(直接发布,无草稿态)
25PUT/api/tutorials/{id}编辑保存
26DELETE/api/tutorials/{id}删除

初始内容:启动时 tutorials 表为空 → 自动导入 doc/*.md 全部文档(不过滤)。

配置模块(2 接口)

#方法路径说明
27GET/api/settings返回全部配置 + sensitive_keys 列表
28PUT/api/settings批量保存 → 写表 → 刷新缓存立即生效

校验规则

  • 数值字段(超时/轮询/大小限制)必须为数字且 >0,否则 422;
  • upload_allow_ext 非空、逗号分隔;
  • 敏感字段(llm_api_key / t2i_token / i2v_token / tts_password)由前端掩码控制显隐。

生效范围:生成管线下次调用即用新参数;资产上传限制即时生效;进行中任务按创建时快照执行。

改进此文档

发现错误或想补充内容?点击在 GitHub 上编辑。