API 文档 BM 影视梦工厂 V3.0

FastAPI 后端 · 37 路由模块 · 211 端路由 · http://127.0.0.1:8000 · 实时 Swagger 文档 →

NAS 表示该端点调用从服务器（192.168.3.140）的远程服务

85
GET
92
POST
18
PUT
16
DELETE
Auth 认证 6 端点
POST/api/v1/auth/login登录，返回 JWT token
POST/api/v1/auth/register注册新用户
POST/api/v1/auth/logout登出
GET/api/v1/auth/me获取当前用户信息
PUT/api/v1/auth/me更新当前用户
POST/api/v1/auth/refresh刷新 token
Projects 项目管理 6 端点
GET/api/v1/projects项目列表
GET/api/v1/projects/{id}项目详情
POST/api/v1/projects创建项目（自动生成剧集）
PUT/api/v1/projects/{id}更新项目
DELETE/api/v1/projects/{id}删除项目
POST/api/v1/projects/{id}/generate-episodes自动生成剧集
Episodes 剧集管理 5 端点
GET/api/v1/episodes剧集列表（project_id 过滤）
GET/api/v1/episodes/{id}剧集详情（含各维度状态）
POST/api/v1/episodes创建剧集
PUT/api/v1/episodes/{id}更新剧集
DELETE/api/v1/episodes/{id}删除剧集
Characters 角色管理 7 端点
GET/api/v1/characters角色列表（project_id 过滤）
GET/api/v1/characters/{id}角色详情
POST/api/v1/characters创建角色
POST/api/v1/characters/{id}/upload-ref-audio上传参考音频
GET/api/v1/characters/{id}/ref-audio获取参考音频
PUT/api/v1/characters/{id}更新角色
DELETE/api/v1/characters/{id}删除角色
Scenes 场景管理 7 端点
GET/api/v1/scenes场景列表
GET/api/v1/scenes/{id}场景详情
POST/api/v1/scenes创建场景
POST/api/v1/scenes/generate-episodes/{episode_id}批量生成场景（LLM 从剧本提取）
POST/api/v1/scenes/{id}/generate-image生成场景图
PUT/api/v1/scenes/{id}更新场景
DELETE/api/v1/scenes/{id}删除场景
Shots 分镜管理 6 端点
GET/api/v1/shots分镜列表（episode_id 过滤）
GET/api/v1/shots/{id}分镜详情
POST/api/v1/shots创建分镜
POST/api/v1/shots/breakdown/{script_id}LLM 拆镜
PUT/api/v1/shots/{id}更新分镜
DELETE/api/v1/shots/{id}删除分镜
Scripts 剧本管理 3 端点
GET/api/v1/scripts剧本列表
POST/api/v1/scripts创建剧本
PUT/api/v1/scripts/{id}更新剧本
Props 道具管理 8 端点
GET/api/v1/props道具列表
GET/api/v1/props/{id}道具详情
GET/api/v1/props/recent最近使用道具
POST/api/v1/props创建道具
POST/api/v1/props/generate/{episode_id}LLM 提取道具
POST/api/v1/props/batch批量创建道具
PUT/api/v1/props/{id}更新道具
DELETE/api/v1/props/{id}删除道具
Assets 资产管理 7 端点
GET/api/v1/assets资产列表（多维度过滤）
GET/api/v1/assets/{id}资产详情
GET/api/v1/assets/by-prompt-hash按 prompt_hash 查询
GET/api/v1/assets/by-episode/{episode_id}按剧集查询
POST/api/v1/assets创建资产
PUT/api/v1/assets/{id}更新资产
DELETE/api/v1/assets/{id}删除资产
Director 导演 Agent 5 端点
POST/api/v1/director/generate-shots/{script_id}LLM 拆镜 + 资源绑定
POST/api/v1/director/smart-match-shot/{shot_id}智能匹配资源到分镜
GET/api/v1/director/script-analysis/{script_id}剧本分析（角色/场景提取）
POST/api/v1/director/batch-confirm批量确认分镜
DELETE/api/v1/director/clear-shots/{episode_id}清空剧集分镜
Director Cases 导演案例库 7 端点
GET/api/v1/director-cases案例列表
GET/api/v1/director-cases/{id}案例详情
POST/api/v1/director-cases/scan扫描 NAS 视频 NAS
POST/api/v1/director-cases/import导入视频分析
POST/api/v1/director-cases/search-similar相似案例搜索
POST/api/v1/director-cases/apply/{shot_id}应用案例到分镜
DELETE/api/v1/director-cases/{id}删除案例
Producer 总调度 Agent 3 端点
GET/api/v1/producer/pipeline-status/{episode_id}流水线状态
POST/api/v1/producer/run-episode-pipeline/{episode_id}执行整集管线
POST/api/v1/producer/run-project-pipeline/{project_id}执行整项目管线
Image Agent 图像生成 Agent 6 端点
GET/api/v1/image-agent/healthComfyUI 健康检查 NAS
GET/api/v1/image-agent/task-status/{task_id}查询任务状态
GET/api/v1/image-agent/tasks任务列表
POST/api/v1/image-agent/generate/shot/{shot_id}生成分镜图 NAS
POST/api/v1/image-agent/generate/character/{character_id}生成角色图 NAS
POST/api/v1/image-agent/generate/scene/{scene_id}生成场景图 NAS
Asset Agent 资产生成 Agent 5 端点
GET/api/v1/asset-agent/status代理状态
POST/api/v1/asset-agent/generate-images/{episode_id}整集批量生成图片
POST/api/v1/asset-agent/generate-image/{shot_id}单分镜生成图片
POST/api/v1/asset-agent/generate-prop-image/{prop_id}生成道具图片
POST/api/v1/asset-agent/regenerate/{shot_id}重新生成分镜图
Video Agent 视频生成 Agent 3 端点
GET/api/v1/video-agent/list/{episode_id}视频列表
POST/api/v1/video-agent/generate/{shot_id}单分镜视频生成
POST/api/v1/video-agent/generate-episode/{episode_id}整集视频生成
Voice 配音 Agent 5 端点
GET/api/v1/voice/list/{episode_id}配音列表
GET/api/v1/voice/status/{task_id}配音任务状态
GET/api/v1/voice/shot/{shot_id}单分镜配音查询
POST/api/v1/voice/generate/{shot_id}单镜头配音 NAS
POST/api/v1/voice/generate-episode/{episode_id}整集配音 NAS
LipSync 口型同步 Agent 4 端点
GET/api/v1/lipsync/list/{episode_id}口型列表
GET/api/v1/lipsync/status/{task_id}任务状态
POST/api/v1/lipsync/generate/{shot_id}单分镜口型 NAS
POST/api/v1/lipsync/generate-episode/{episode_id}整集口型 NAS
Export 导出 Agent 3 端点
GET/api/v1/export/list/{episode_id}导出列表
GET/api/v1/export/{id}导出详情
POST/api/v1/export/export-episode/{episode_id}导出成片
Overseas 海外平台导出 5 端点
POST/api/v1/overseas/subtitles/{episode_id}生成海外字幕
POST/api/v1/overseas/dubbing-script/{episode_id}生成配音脚本
POST/api/v1/overseas/metadata/{episode_id}生成平台元数据
POST/api/v1/overseas/export/{episode_id}全量导出
GET/api/v1/overseas/config获取平台配置
Subtitle 字幕 Agent 4 端点
GET/api/v1/subtitle/{episode_id}获取字幕
POST/api/v1/subtitle/generate/{episode_id}生成字幕（SRT/VTT/ASS）
POST/api/v1/subtitle/translate/{episode_id}字幕翻译
POST/api/v1/subtitle/upload上传字幕文件
Continuity 连续性检查 5 端点
GET/api/v1/continuity/{episode_id}获取连续性报告
POST/api/v1/continuity/check/{episode_id}执行连续性检查
POST/api/v1/continuity/fix/{episode_id}自动修复问题
POST/api/v1/continuity/check-character/{character_id}检查角色一致性
POST/api/v1/continuity/check-timeline/{episode_id}检查时间线一致性
Review 内容审核 5 端点
GET/api/v1/review/results/{episode_id}审核结果
POST/api/v1/review/review-content审核内容（通用）
POST/api/v1/review/review-episode/{episode_id}审核整集
POST/api/v1/review/approve/{project_id}通过审核
POST/api/v1/review/reject/{project_id}驳回审核
Knowledge 知识库 11 端点
GET/api/v1/knowledge知识列表
GET/api/v1/knowledge/{id}知识详情
POST/api/v1/knowledge创建知识
POST/api/v1/knowledge/extract从文本提取知识
POST/api/v1/knowledge/search知识搜索
POST/api/v1/knowledge/web-research联网研究
POST/api/v1/knowledge/enrich-script/{script_id}知识增强剧本
POST/api/v1/knowledge/generate-structure/{knowledge_id}生成知识结构
POST/api/v1/knowledge/check-accuracy/{knowledge_id}准确性校验
PUT/api/v1/knowledge/{id}更新知识
DELETE/api/v1/knowledge/{id}删除知识
Marketing 营销素材 11 端点
GET/api/v1/marketing素材列表
GET/api/v1/marketing/{id}素材详情
GET/api/v1/marketing/by-project/{project_id}按项目查询
POST/api/v1/marketing创建素材
POST/api/v1/marketing/generate-poster生成海报文案
POST/api/v1/marketing/generate-trailer生成预告脚本
POST/api/v1/marketing/generate-social生成社媒内容
POST/api/v1/marketing/publish/{id}发布素材
POST/api/v1/marketing/auto-generate/{episode_id}自动生成全套
PUT/api/v1/marketing/{id}更新素材
DELETE/api/v1/marketing/{id}删除素材
Translation 多语种翻译 8 端点
GET/api/v1/translation翻译任务列表
GET/api/v1/translation/{id}任务详情
GET/api/v1/translation/languages支持语言列表
POST/api/v1/translation创建翻译任务
POST/api/v1/translation/translate-episode/{episode_id}翻译整集
POST/api/v1/translation/translate-shot/{shot_id}翻译单分镜
POST/api/v1/translation/retry/{id}重试翻译
POST/api/v1/translation/custom-adapt文化适应性调整
Resource Req 资源需求管理 9 端点
GET/api/v1/resource-requirements需求列表
GET/api/v1/resource-requirements/{id}需求详情
POST/api/v1/resource-requirements创建需求
POST/api/v1/resource-requirements/extract/{episode_id}从剧本提取需求
POST/api/v1/resource-requirements/match/{requirement_id}智能匹配资源
POST/api/v1/resource-requirements/batch-match/{episode_id}批量匹配
POST/api/v1/resource-requirements/profile-resource资源画像分析
PUT/api/v1/resource-requirements/{id}更新需求
DELETE/api/v1/resource-requirements/{id}删除需求
Workflows 工作流引擎 8 端点
GET/api/v1/workflows工作流定义列表
GET/api/v1/workflows/{id}工作流定义详情
GET/api/v1/workflows/instances实例列表
POST/api/v1/workflows创建工作流定义
POST/api/v1/workflows/run运行工作流实例
POST/api/v1/workflows/cancel/{instance_id}取消实例
PUT/api/v1/workflows/{id}更新工作流
DELETE/api/v1/workflows/{id}删除工作流
Tasks 任务队列 7 端点
GET/api/v1/tasks任务列表
GET/api/v1/tasks/{id}任务详情
GET/api/v1/tasks/by-status/{status}按状态查询
GET/api/v1/tasks/count-by-status状态统计
POST/api/v1/tasks创建任务
PUT/api/v1/tasks/{id}更新任务
DELETE/api/v1/tasks/{id}删除任务
Models 模型管理 4 端点
GET/api/v1/models模型清单
GET/api/v1/models/health模型健康状态
GET/api/v1/models/{name}/status单个模型状态
POST/api/v1/models/check-all检查全部模型
Search 统一搜索 4 端点
GET/api/v1/search全局搜索
GET/api/v1/search/projects搜索项目
GET/api/v1/search/characters搜索角色
GET/api/v1/search/assets搜索资产
Centers 跨中心概览 4 端点
GET/api/v1/centers/overview/{project_id}项目跨中心概览
POST/api/v1/centers/format-status/{project_id}各格式产出状态
POST/api/v1/centers/quick-convert/{script_id}快速格式转换
POST/api/v1/centers/check-consistency/{project_id}跨中心一致性检查
Events SSE 事件流 1 端点
GET/api/v1/events/streamSSE 进度推送流
Monitor 系统监控 3 端点
GET/api/v1/monitor/health系统健康状态
GET/api/v1/monitor/services服务运行状态 NAS
GET/api/v1/monitor/gpuGPU 状态 NAS

v3 新增 — 四中心扩展

Novels 小说中心 13 端点
GET/api/v1/novels小说项目列表
GET/api/v1/novels/{id}小说详情
GET/api/v1/novels/{id}/volumes卷列表
GET/api/v1/novels/{id}/chapters章列表
GET/api/v1/novels/volumes/{id}卷详情
POST/api/v1/novels创建小说项目
POST/api/v1/novels/{id}/volumes创建卷
POST/api/v1/novels/{id}/chapters创建章
POST/api/v1/novels/generate-outline/{novel_id}LLM 生成卷纲
POST/api/v1/novels/generate-chapter/{chapter_id}LLM 生成正文
POST/api/v1/novels/import-from-script/{script_id}从剧本导入
PUT/api/v1/novels/{id}更新小说
DELETE/api/v1/novels/{id}删除小说
Audio Dramas 广播剧中心 17 端点
GET/api/v1/audio-dramas广播剧列表
GET/api/v1/audio-dramas/{id}广播剧详情
GET/api/v1/audio-dramas/{id}/tracks音轨列表
GET/api/v1/audio-dramas/{id}/tracks/{track_id}音轨详情
GET/api/v1/audio-dramas/{id}/mix混音详情
GET/api/v1/audio-dramas/{id}/export导出状态
GET/api/v1/audio-dramas/export/list导出记录列表
POST/api/v1/audio-dramas创建广播剧
POST/api/v1/audio-dramas/{id}/tracks创建音轨
POST/api/v1/audio-dramas/generate-voice/{audio_drama_id}配音生成 NAS
POST/api/v1/audio-dramas/generate-mix/{audio_drama_id}混音合成
POST/api/v1/audio-dramas/export/{audio_drama_id}导出成品
PUT/api/v1/audio-dramas/{id}更新广播剧
PUT/api/v1/audio-dramas/tracks/{id}更新音轨
DELETE/api/v1/audio-dramas/{id}删除广播剧
DELETE/api/v1/audio-dramas/tracks/{id}删除音轨
POST/api/v1/audio-dramas/import-from-comic从漫剧导入
Digital Humans 数字人中心 18 端点
GET/api/v1/digital-humans数字人列表
GET/api/v1/digital-humans/{id}数字人详情
GET/api/v1/digital-humans/{id}/scripts口播脚本列表
GET/api/v1/digital-humans/{id}/videos视频列表
GET/api/v1/digital-humans/scripts/{script_id}脚本详情
GET/api/v1/digital-humans/videos/{video_id}视频详情
GET/api/v1/digital-humans/videos/{video_id}/shots视频镜头列表
POST/api/v1/digital-humans创建数字人
POST/api/v1/digital-humans/{id}/scripts创建口播脚本
POST/api/v1/digital-humans/{id}/bind-voice绑定声音 NAS
POST/api/v1/digital-humans/{id}/generate-video生成口播视频（完整管线）NAS
POST/api/v1/digital-humans/generate-shot-audio/{shot_id}单镜头语音生成 NAS
POST/api/v1/digital-humans/generate-shot-lipsync/{shot_id}单镜头口型同步 NAS
POST/api/v1/digital-humans/compose-video/{video_id}合成最终视频
POST/api/v1/digital-humans/export/{video_id}导出视频
PUT/api/v1/digital-humans/{id}更新数字人
DELETE/api/v1/digital-humans/{id}删除数字人
Script Conversion 格式转换 5 端点
GET/api/v1/script-conversion转换记录列表
GET/api/v1/script-conversion/{id}转换记录详情
GET/api/v1/script-conversion/latest最近转换记录
POST/api/v1/script-conversion/convert格式转换
POST/api/v1/script-conversion/preview预览转换结果
System 系统 & 健康检查 2 端点
GET/根路径
GET/health健康检查

API 端点列表 · BM 影视梦工厂 V3.0 · 共 37 路由模块 211 端点（85 GET / 92 POST / 18 PUT / 16 DELETE）