API 文档 影视梦工厂 v3.0

FastAPI 后端 · 24 组 / 131 个端点 · http://127.0.0.1:8001

51
GET
57
POST
14
PUT
9
DELETE
22
已开发
2
待实现
Auth 认证 2 端点
POST/api/v1/auth/login登录，返回 JWT token
POST/api/v1/auth/register注册新用户
Worlds 世界观 4 端点
GET/api/v1/worlds获取所有世界观
GET/api/v1/worlds/{id}获取单个世界观
POST/api/v1/worlds创建世界观
PUT/api/v1/worlds/{id}更新世界观
Characters 角色 5 端点
GET/api/v1/characters获取角色列表（支持 world_id 过滤）
GET/api/v1/characters/{id}获取单个角色
POST/api/v1/characters创建角色（含 ref_audio 上传）
PUT/api/v1/characters/{id}更新角色
DELETE/api/v1/characters/{id}删除角色
Episodes 剧集 4 端点
GET/api/v1/episodes获取剧集列表
GET/api/v1/episodes/{id}获取单个剧集
POST/api/v1/episodes创建剧集
PUT/api/v1/episodes/{id}更新剧集
Scripts 剧本 4 端点
GET/api/v1/scripts获取剧本列表（支持 episode_id 过滤）
GET/api/v1/scripts/{id}获取单个剧本
POST/api/v1/scripts创建剧本
POST/api/v1/scripts/generateLLM 生成剧本（科普模式可选）
Scenes 场景 5 端点
GET/api/v1/scenes获取场景列表
GET/api/v1/scenes/{id}获取单个场景
POST/api/v1/scenes创建场景
PUT/api/v1/scenes/{id}更新场景
DELETE/api/v1/scenes/{id}删除场景
Shots 分镜 8 端点
GET/api/v1/shots分镜列表
GET/api/v1/shots/{id}单个分镜详情
POST/api/v1/shots创建分镜
PUT/api/v1/shots/{id}更新分镜
DELETE/api/v1/shots/{id}删除分镜
POST/api/v1/shots/breakdown/{script_id}LLM 拆镜
POST/api/v1/shots/batch-confirm批量确认分镜
POST/api/v1/director/smart-match-shot/{shot_id}智能匹配资源
Assets 资产 5 端点
GET/api/v1/assets资产列表
GET/api/v1/assets/{id}单个资产
POST/api/v1/assets创建资产
POST/api/v1/assets/generate-images/{episode_id}整集批量生成图片
POST/api/v1/assets/generate-image/{shot_id}单分镜生成图片
Props 道具 4 端点
GET/api/v1/props道具列表
GET/api/v1/props/{id}单个道具
POST/api/v1/props创建道具
POST/api/v1/props/generate/{episode_id}生成道具（LLM 分析源文本提取道具）
Videos 视频 4 端点
POST/api/v1/video/generate/{shot_id}单分镜视频生成
POST/api/v1/video/generate-episode/{episode_id}整集视频生成
GET/api/v1/video/status/{task_id}视频任务状态查询
GET/api/v1/video/list/{episode_id}剧集视频列表
Voice 配音 6 端点
POST/api/v1/voice/generate/{shot_id}单镜头配音
POST/api/v1/voice/generate-episode/{episode_id}整集配音
GET/api/v1/voice/status/{task_id}配音任务状态
GET/api/v1/voice/list/{episode_id}配音列表
POST/api/v1/voice/test-tts测试 TTS（上传文本试听）
PUT/api/v1/voice/{id}/regenerate重新生成单条配音
LipSync 口型同步 4 端点
POST/api/v1/lipsync/generate/{shot_id}单分镜口型
POST/api/v1/lipsync/generate-episode/{episode_id}整集口型
GET/api/v1/lipsync/status/{task_id}口型任务状态
GET/api/v1/lipsync/list/{episode_id}口型列表
Subtitles 字幕 3 端点
POST/api/v1/subtitles/generate/{episode_id}生成字幕
GET/api/v1/subtitles/{episode_id}获取字幕
PUT/api/v1/subtitles/{id}更新字幕
Exports 导出 5 端点
GET/api/v1/exports导出列表
GET/api/v1/exports/{id}导出详情
POST/api/v1/exports/export/{episode_id}导出成片
GET/api/v1/exports/download/{id}下载成片
DELETE/api/v1/exports/{id}删除导出记录
Prompts Prompt 模板 4 端点
GET/api/v1/prompts模板列表
GET/api/v1/prompts/{id}模板详情
POST/api/v1/prompts创建模板
PUT/api/v1/prompts/{id}更新模板
Image Agent 图像生成 5 端点
POST/api/v1/image-agent/generate/{shot_id}单分镜生成
POST/api/v1/image-agent/generate-episode/{episode_id}整集批量生成
GET/api/v1/image-agent/task-status/{task_id}任务状态轮询
GET/api/v1/image-agent/queue-status队列状态查询
POST/api/v1/image-agent/generate-prop-image/{prop_id}生成道具图片
Knowledge 知识库 8 端点
GET/api/v1/knowledge知识列表
GET/api/v1/knowledge/{id}知识详情
POST/api/v1/knowledge创建知识
PUT/api/v1/knowledge/{id}更新知识
DELETE/api/v1/knowledge/{id}删除知识
POST/api/v1/knowledge/search知识搜索
POST/api/v1/knowledge/web-research联网研究（DuckDuckGo）
POST/api/v1/knowledge/enrich-script/{script_id}知识增强剧本
Tasks 制作任务 4 端点
GET/api/v1/tasks任务列表
GET/api/v1/tasks/{id}任务详情
POST/api/v1/tasks/batch-generate-images/{episode_id}批量图片生成任务
POST/api/v1/tasks/batch-confirm批量确认
Characters 角色扩展 2 端点
POST/api/v1/characters/{id}/upload-ref-audio上传角色参考音频
GET/api/v1/characters/{id}/ref-audio获取角色参考音频
System 系统 6 端点
GET/api/v1/health健康检查
GET/api/v1/config系统配置
PUT/api/v1/config更新系统配置
GET/api/v1/ollama/statusOllama 状态
POST/api/v1/ollama/switch-model切换 LLM 模型
GET/api/v1/comfyui/statusComfyUI 状态
Director Cases 导演案例库 6 端点 NEW
GET/api/v1/director-cases/案例列表
GET/api/v1/director-cases/{id}案例详情
POST/api/v1/director-cases/scan扫描 NAS 视频
POST/api/v1/director-cases/import/{video_path}导入视频
POST/api/v1/director-cases/search相似案例搜索
DELETE/api/v1/director-cases/{id}删除案例
Review 审核 3 端点
POST/api/v1/review/continuity/{episode_id}连续性检查
GET/api/v1/review/results/{episode_id}审核结果
GET/api/v1/review/aggregate/{episode_id}审核汇总

v3 新增 — 影视工厂扩展中心

Novel 小说中心 17 端点
GET/api/v1/novels小说项目列表
POST/api/v1/novels创建小说项目
GET/api/v1/novels/{id}小说项目详情
PUT/api/v1/novels/{id}更新小说项目
DELETE/api/v1/novels/{id}删除小说项目
GET/api/v1/novels/{id}/volumes卷列表
POST/api/v1/novels/{id}/volumes创建卷
GET/api/v1/novels/volumes/{id}卷详情
PUT/api/v1/novels/volumes/{id}更新卷
GET/api/v1/novels/{id}/chapters章列表
POST/api/v1/novels/{id}/chapters创建章
GET/api/v1/novels/chapters/{id}章详情
PUT/api/v1/novels/chapters/{id}更新章
DELETE/api/v1/novels/chapters/{id}删除章
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}从剧本导入
Audio Drama 广播剧中心 11 端点
GET/api/v1/audio-dramas广播剧列表
POST/api/v1/audio-dramas创建广播剧
GET/api/v1/audio-dramas/{id}广播剧详情
PUT/api/v1/audio-dramas/{id}更新广播剧
DELETE/api/v1/audio-dramas/{id}删除广播剧
GET/api/v1/audio-dramas/{id}/tracks音轨列表
POST/api/v1/audio-dramas/{id}/tracks创建音轨
PUT/api/v1/audio-dramas/tracks/{id}更新音轨
DELETE/api/v1/audio-dramas/tracks/{id}删除音轨
POST/api/v1/audio-dramas/generate-voice/{audio_drama_id}配音生成
POST/api/v1/audio-dramas/generate-mix/{audio_drama_id}混音合成
Digital Human 数字人中心 8 端点
GET/api/v1/digital-humans数字人列表
POST/api/v1/digital-humans创建数字人
GET/api/v1/digital-humans/{id}数字人详情
PUT/api/v1/digital-humans/{id}更新数字人
DELETE/api/v1/digital-humans/{id}删除数字人
POST/api/v1/digital-humans/generate-video/{dh_id}生成口播视频
POST/api/v1/digital-humans/bind-voice/{dh_id}绑定声音
GET/api/v1/digital-humans/{id}/videos视频列表
Script Conversion 格式转换 4 端点
POST/api/v1/script-conversion/convert格式转换（source_id + target_format）
GET/api/v1/script-conversion/list转换记录列表
GET/api/v1/script-conversion/{id}转换详情
POST/api/v1/script-conversion/preview预览转换结果
Unified 统一资源库 5 端点
GET/api/v1/unified/projects跨中心项目列表
GET/api/v1/unified/characters统一角色列表
GET/api/v1/unified/scripts统一剧本列表（format_type 过滤）
GET/api/v1/unified/assets统一素材列表
GET/api/v1/unified/tasks统一任务中心

API 端点列表 · 影视梦工厂 v3.0 · 共 24 组 131 端点