README

PRINTFILM

Languages: 中文 | English




 把故事做成能播的片子 — AI 漫剧与 AI 短视频，从文案到成片。

分步短视频创作：创作设置 → 文案与分镜 → 参考图生图 → 图生视频 → 合成预览。新建默认 AI 视频、3D 动画画风、9:16 竖屏、约 60 秒，也可选择静图成片，各阶段检查与编辑后再继续制作。

源码：github.com/yi1108/printfilm · 版本 0.2.0

 界面预览

工作台

!工作台

AI 短视频 — 历史、分镜、成片

| 项目历史 | 分镜工作台 | 成片预览 |
|:---:|:---:|:---:|
| !科普历史 | !分镜工作台 | !成片预览 |

AI 漫剧 — 项目、分集、剧本、分镜、资产

| 项目列表 | 分集工作台 | 剧本解析 |
|:---:|:---:|:---:|
| !漫剧项目列表 | !分集工作台 | !剧本解析 |

| 分镜编辑 | 资产库 | 管理后台 |
|:---:|:---:|:---:|
| !分镜编辑 | !漫剧资产库 | !管理后台 |

 核心功能

 1. AI 漫剧

从一句话到分集成片，角色与场景可复用。

- 大纲 / 剧情摘要 / 剧本内容
- 资产库：角色、场景、道具
- 解析成镜后进入分镜编辑与画布
- 细则见 docs/EPISODE_RULES.md

 2. AI 短视频

在 /history 通过项目卡片管理短视频，点击新建进入 /studio/new。

- 精选四款非真人风格：3D 动画、二维动漫、绘本插画、国风水墨
- 输入想法生成文案，或粘贴已有文案；文案可编辑并保存草稿
- 确认文案后生成分镜，逐镜编辑旁白与画面；每镜使用固定画风参考图，并参考前镜图片延续角色与视觉风格
- AI 视频模式把每镜图片生成为带声音的镜头视频，支持单镜预览和重生；选择模型与清晰度后分阶段生成，再手动合成成片
- 静图模式生成图片和外部 TTS 配音，FFmpeg 添加图片运镜和字幕；两种模式都支持预览、下载
- 制作中可停止，失败时继续补齐缺失素材；离开页面后可回到项目恢复进度
- 旧对话项目在任务停止并结算后移交分步编辑，各历史版本保留原素材

 3. 独立生成与短剧 Skills

图片、视频、音频提供独立生成入口；短剧创作技能见短剧Skills。

 4. 管理后台

用户、订单、模板、任务中心和模型路由。

 工作流程


选择画风、输入想法或已有文案
    → 编辑与保存文案 → 确认后生成分镜
    → 检查分镜卡片 → 使用画风参考图生成图片
    → AI 视频：图片生成镜头视频与声音 → 检查并合成
      静图成片：生成外部 TTS 配音 → 合成运镜、字幕与旁白
    → 预览与下载成片


每个阶段完成后停下来等待检查，下一步由用户明确启动。项目列表、分镜和素材均采用卡片展示。漫剧和工具中心沿用原有流程。

当前新建短片直接使用项目接口，旧对话会话的创建、消息及查询接口已移除，仅保留历史项目转入工作台的 open-editor 接口。历史任务恢复与项目交接仍依赖 creation_sessions、creation_messages、creation_runs 及项目会话字段；目标时长字段同时供当前流程使用。默认启动会自动处理结构；已有数据库设置 DATABASE_BOOTSTRAP_ENABLED=false 时，先在 backend 目录执行以下专用增量迁移，再重启后端。该命令只创建上述三张表、两个项目字段及索引，不执行种子数据，也不修改其他业务结构或已有数据；可重复运行。

bash
python scripts/prepare_creation_schema.py
python scripts/prepare_creation_schema.py --check


Windows 可将 python 替换为 .venv\Scripts\python.exe；使用 backend/.env 的现有数据库配置。--check 只读检查，结构缺失时返回非零退出码。

 技术特点

- 两条产品线共用一套生成能力 — 漫剧与短视频走同一上游
- 进程内任务平台 — scheduler / executor / poller，无需单独 Celery Worker
- 模型可换 — 管理后台配置 TokenFree Key 与模型，不必改代码
- Docker 一键启动 — 公开镜像，拉取无需登录
- 可选计费 — 默认关闭；开启后按用量结算，见 docs/BILLING.md

 技术栈

| 层 | 选型 |
|----|------|
| 后端 | Python 3.12 · FastAPI · SQLAlchemy · PostgreSQL · Redis |
| 前端 | React 19 · TypeScript · Vite 8（管理端 Tailwind + shadcn） |
| AI | TokenFree New API（文字 / 图 / 视频） |
| 部署 | Docker 全栈镜像，或本机三进程 + 中间件容器 |

 快速开始（Docker 一键启动）

本机只需安装 Docker Desktop（或 Docker Engine + Compose）。镜像在阿里云 ACR gcc 公开命名空间，拉取无需登录。

 1. 克隆并准备环境变量

bash
git clone https://github.com/yi1108/printfilm.git
cd printfilm

cp deploy/.env.docker.example deploy/.env.docker


编辑 deploy/.env.docker，至少改这三项：

| 变量 | 说明 |
|------|------|
| POSTGRES_PASSWORD | 数据库密码（勿用示例默认值） |
| SECRET_KEY | 任意长随机串（会话 / 密钥加密） |
| OPENAI_API_KEY / ARK_API_KEY | TokenFree API Key（同一把填两处即可） |

无 Key 想先看界面：把 ARK_MOCK=true。

 2. 一键启动

bash
docker compose --env-file deploy/.env.docker up -d


等约半分钟（API 健康检查通过后，web / admin 才会起来）。

| 服务 | 地址 |
|------|------|
| 用户端 | http://localhost:8080 |
| 管理后台 | http://localhost:8081 |
| API / 文档 | http://localhost:8000 · /docs |
| 健康检查 | http://localhost:8000/api/health |

常用：

bash
docker compose --env-file deplo

Top issues

Latest release

Summary
- Seedance 2.5：时长计费、欠费修复、参考音色/参考图，画布自定义时长支持到 30s（含 20/25/30 预设）
- TokenFree 视频：优先 content 直链 / TOS 302 下载，下载中断重试与更清晰错误提示
- 漫剧：分镜流水线、预算与提示词相关修复；计费/上游用量与测试补强

 Deploy
- ACR：printfilm-{api,web,admin-web}:v0.3.0 / latest
- 自托管：docker compose --env-file deploy/.env.docker pull && up -d