本文档对应页面 /video/creative(新建创作)与 /video/creative?project=20(编辑已有项目)。
所有接口均为管理台同源接口,统一前缀 /video/api,响应统一为
{"code":200,"message":"ok","data":…}。成功以 code=200 判断。
每个接口卡片都可以直接填写参数并发送真实请求。
BASE/video/api同源 · Cookie 会话
请求域名
请求头
鉴权
location.origin(同源相对路径)JSON 接口:
上传接口Accept: application/json、X-Requested-With: XMLHttpRequest;写操作附带 X-XSRF-TOKEN(文档页会自动读取 Cookie)multipart/form-data,文件字段名 file,可附带 kind当前管理台接口挂在
响应包裹web 中间件组,沿用浏览器会话;上线前应在路由上追加登录/权限中间件{ code, message, data };业务失败通常返回 HTTP 200 + code=4xx,表单校验失败可能是 HTTP 422 + Laravel errors页面首次打开会自动 GET
/video/api/creative/meta,该请求同时下发 XSRF-TOKEN Cookie;本调试页也已在加载时预热一次,后续 POST/PUT/DELETE 才能通过 CSRF 校验。FLOW页面启动时加载了什么/video/creative?project=20
| 顺序 | 请求 | 用途 | 页面落点 |
|---|---|---|---|
| 1 | GET /video/creative?project=20 | 服务端渲染页面;带 project 时隐藏输入台/模板区,输出 data-project-id="20" | #vgCreative |
| 2 | GET /video/api/creative/meta | 类型 / 风格 / 比例 / 像素 / 模式 / 景别 / 语速 / 封面模板等字典与默认值 | 输入台与全局设定下拉 |
| 3 | GET /video/api/script/video-models | 可用于分镜视频的模型列表(含点数) | #cModel / #gModel |
| 4 | GET /video/api/projects?template=1&page=1&per=6 | 模板分页(仅新建页显示) | 模板卡片 + 分页器 |
| 5 | GET /video/api/creative/{id} | 当 project > 0 时加载完整创作会话 | 工作区全部面板 |
| 6 | 轮询 GET /video/api/creative/{id} | 生成中或资产出图未完成时每 4 秒刷新 | 角色 / 场景 / 道具 / 分镜 |
新建创作时输入台上传的剧本 / 视频 / 图片会先走
POST /video/api/files/upload,再以 {kind,file_no,name} 数组写入 attachments。MAP页面分区与接口快速定位
| 页面区域 | 主要接口 | 说明 |
|---|---|---|
| 输入台(仅新建) | POST /creative/generate、POST /files/upload | 文案 + 类型/比例/风格/像素/模型/模式 + 素材附件 |
| 选择模板(仅新建) | GET /projects?template=1 | 分页 per=6,支持 keyword / genre |
| 全局设定 | GET/PUT /creative/{id} | 标题、风格、像素、视频模型、手动/自动模式 |
| 资源数据 | PUT /creative/{id}(attachments) | 剧本 / 视频 / 图片预览,文档走 files/{no}/text |
| 角色 / 场景 / 道具 | POST/PUT/DELETE /creative/{id}/assets…、POST /assets/{id}/generate | CRUD + 一键出图 + 音色绑定 |
| 分镜列表 / 编辑器 | POST/PUT/DELETE /creative/{id}/shots… | 新增、自动保存(600ms 防抖)、删除、拖选预览 |
| 生成分镜图片 | GET /models?type=ai_image… → POST …/generate → GET /tasks/{no} → PUT …/shots/{id} | 成功后回填首帧 first_frame_file_no |
| 生成分镜视频 | GET /models?type=ai_video… → POST …/generate → GET /tasks/{no} | 成功后刷新会话,读取分镜 video_url |
| 封面编辑 | POST /files/upload → POST /creative/{id}/cover | canvas 导出 600×800 PNG 后保存封面配置 |
| 项目参数编辑 | GET/PUT /projects/{id} | 名称、题材、风格、画幅、时长、像素、厂商、预算、config、设为模板 |