视频创造 API

创作会话 · 项目参数 · 角色/场景/道具 · 分镜图片/视频生成 · 数据渲染
同源调用

本文档对应页面 /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
顺序请求用途页面落点
1GET /video/creative?project=20服务端渲染页面;带 project 时隐藏输入台/模板区,输出 data-project-id="20"#vgCreative
2GET /video/api/creative/meta类型 / 风格 / 比例 / 像素 / 模式 / 景别 / 语速 / 封面模板等字典与默认值输入台与全局设定下拉
3GET /video/api/script/video-models可用于分镜视频的模型列表(含点数)#cModel / #gModel
4GET /video/api/projects?template=1&page=1&per=6模板分页(仅新建页显示)模板卡片 + 分页器
5GET /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}/generateCRUD + 一键出图 + 音色绑定
分镜列表 / 编辑器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}/covercanvas 导出 600×800 PNG 后保存封面配置
项目参数编辑GET/PUT /projects/{id}名称、题材、风格、画幅、时长、像素、厂商、预算、config、设为模板