把 Windows RTX 电脑变成本地 AI 创作站，也把 ComfyUI 工作流变成可供其他软件调用的 API。
在一个客户端中准备运行环境、导入或选择工作流、检查并下载所需模型，在本机完成文字、图片和视频生成。使用已经配置好的工作流时，无需直接操作 ComfyUI 节点图。
同一台电脑上的程序可通过“本地 API + API Key”调用；远程程序可使用“公网 URL + API Key”。模型与生成结果默认保存在本机，具体能力和显存需求取决于已安装的工作流和模型。
下载 Windows 版 · 快速开始 · API 文档 · 使用教学 PDF
公网访问说明： 当前版本启动后默认尝试建立带鉴权的公网 Tunnel；不需要公网访问时，可停止公网连接或全部后台服务。
下载安装 → 一键修复运行环境并下载所需模型 → 选择工作流，在示例页发起第一次生成
- 文字生成：调用已安装的文字模型，完成问答、创作和内容整理。
- 图片生成与编辑：使用文生图、图生图等工作流完成视觉创作。
- 视频生成：使用首尾帧等视频工作流生成动态内容。
- 环境与模型管理：自动检查缺少的运行环境和模型，并提供修复、下载与更新入口。
- 给其他软件调用：同一台电脑优先使用控制台提供的本地 API；远程调用使用公网 URL，两者共用同一个 API Key。
具体能力取决于你已经安装并启用的工作流和模型。
| 你是 | 从这里开始 |
|---|---|
| 普通创作者 | 下载客户端，准备环境和模型，选择可用工作流后在示例页生成 |
| ComfyUI 用户 | 导入已有工作流，让客户端检查依赖、模型和公开调用参数 |
| 开发者 | 使用本地 API 或公网 URL + API Key，对接文字、图片、视频和异步任务接口 |
- 从 Releases 下载并安装
LingJingAI-Setup-1.0.3-win-x64.exe。 - 启动“灵境造片厂”，进入“模型与环境”，点击“一键修复”。
- 等待客户端自动下载、校验并安装运行环境；如果自动拉取失败，再按弹窗提示手动下载环境包。
- 在模型列表中点击“下载模型”，补齐你准备使用的工作流所需模型。
- 选择一个显示“可以使用”的工作流，并将它设为默认工作流。
- 回到“控制台”；本机程序复制“本地 API”，远程程序复制“公网 URL”，并同时复制 API Key。
- 打开桌面上的“灵境造片厂示例页”，填入 URL 和 Key，即可尝试文字、图片或视频生成。
安装目录中的《灵境造片厂使用教学.pdf》包含更完整的图文步骤。
- Windows 10 22H2 或 Windows 11，64 位。
- NVIDIA RTX 20 系列或更高，显存 8GB 或以上；8GB 仅适合轻量工作流，WAN 14B、LTX-2.3 等大型工作流以客户端详情页标出的要求为准。
- 当前 CUDA 13 环境需要 NVIDIA 580 或更高版本驱动。
- 为运行环境、模型和生成结果预留足够磁盘空间。
- 推荐安装在固态硬盘中；模型首次加载速度会明显快于机械硬盘。
| 文件 | 用途 |
|---|---|
LingJingAI-Setup-1.0.3-win-x64.exe |
必装的轻量客户端，包含界面和启动所需组件 |
runtime-nvidia-rtx20plus-cu130-v1.0.0.7z |
独立运行环境；通常由客户端自动下载，网络失败时再手动下载 |
| 模型文件 | 按工作流分别下载，不包含在客户端或运行环境包中 |
客户端和运行环境分开发布。两个安装包都不包含模型或用户数据；升级客户端不会重复下载整套环境，也不会把模型和生成结果打进安装包。
客户端不会预装大型模型。缺少模型的工作流仍会显示，并明确列出需要下载的文件。补齐后点击“重新检查”即可。
首次下载运行环境和模型时需要联网。环境与模型准备完成后，本机生成本身可以离线运行，但客户端默认会尝试建立公网 Tunnel；完全离线使用时请停止公网连接或全部后台服务。
它是随客户端安装的本地纯前端页面，用来帮助第一次使用的用户快速发起调用。它不会替代客户端、运行环境或模型，API Key 只保留在当前浏览器会话中。
默认保存在安装目录的 outputs 文件夹。卸载客户端时会删除程序、后装运行环境和模型，但保留 outputs 中的生成资产。
不会自动上传。默认生成过程在本机完成；客户端启动后会自动尝试建立带鉴权的公网 Tunnel，只有拿到公网 URL 和有效 API Key 的调用方才能提交任务或读取对应结果。不需要公网访问时，可在客户端停止全部后台服务；请勿公开 URL、API Key 或包含它们的截图。
只有你主动登录时，客户端才会向你填写的服务端同步公网 URL、本机 API Key、设备名称、工作流/模型状态和不含提示词的任务进度，供平台代为调用。生成提示词和生成结果不在该同步数据中。自定义服务端将取得调用本机接口的凭据，只应登录可信服务；不登录不影响完整本地功能。
当前版本退出登录会停止后续平台同步，但不会自动更换已经共享给平台的 API Key。如果不再信任该平台，请先退出登录，再到“设置”中重新生成访问密钥；API 重启后旧 Key 将无法继续调用本机服务。
- 最新版本：GitHub Releases
- 当前版本：
1.0.3 - 本项目中由项目作者拥有版权并有权授权的客户端源码和文档采用 Apache License 2.0 开源。
- 主要第三方组件及许可证提示见 THIRD_PARTY_NOTICES.md。
- 第三方组件、外部工作流、模型和素材仍分别遵守其来源方许可证与使用条款，详见开源许可说明。
以下内容供需要对接接口、制作工作流或排查环境的开发者阅读。
调用方（示例页 / 网页 / 服务端 / 其他软件）
│ URL + API Key
▼
灵境造片厂客户端 ── 工作流路由 ── ComfyUI / 本地模型
│
└── Cloudflare Tunnel（客户端默认尝试建立，可停止后台服务关闭）
轻量客户端包含打开完整界面所需的便携 Python、Tk 和 7-Zip，不要求用户另装 Python。ComfyUI、Torch、CUDA 与 Cloudflared 位于独立运行环境包中。
将示例中的 BASE_URL 和 API_KEY 替换为客户端控制台显示的值。
curl -X POST "BASE_URL/" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"一只在窗边晒太阳的猫"}'指定公开名称为 flux2 的工作流：
curl -X POST "BASE_URL/flux2" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"电影感城市夜景"}'| 方法 | 路径 | 用途 |
|---|---|---|
GET |
/healthz |
无鉴权的最小存活状态 |
GET |
/v1/status |
客户端完整运行状态 |
GET |
/v1/models |
可调用模型列表 |
GET |
/v1/workflows |
可调用工作流列表 |
POST |
/v1/chat/completions |
OpenAI 风格文字接口 |
POST |
/api/v3/images/generations |
即梦 / 火山风格图片接口 |
POST |
/v1/workflows/run/{workflow_id} |
直接运行指定工作流 |
GET |
/v1/tasks/{task_id} |
查询异步任务 |
GET |
/v1/files/{task_id}/{filename} |
下载任务生成的文件 |
生成任务默认异步执行。提交后先取得任务 ID，再查询进度和结果，避免长时间生成造成请求超时。
- 每个工作流位于
workflows/<工作流名称>/，至少包含manifest.json和workflow.json。 manifest.json定义公开名称、输出类型、输入参数和模型依赖。- 模型统一存放在根目录
models/，名称必须与工作流引用一致。 - 推荐仅使用可信来源的
safetensors或GGUF文件；不要导入来源不明的传统 PyTorch checkpoint。 - 工作流、运行环境和模型相互分离，更新客户端不会删除模型。
源码目录已经具备完整便携环境时：
start.bat环境诊断：
check-env.batTrae 或 VS Code 应选择 runtime\python\python.exe。仓库中的 .vscode/settings.json 已固定该解释器；便携环境只使用 .venv\Lib 保存依赖。
- 生成 API Key 与本机管理 Key 权限分离，管理接口不应交给外部调用方。
- 客户端生成的 API Key 与本机管理 Key 使用当前用户 DPAPI 保护，日志不会输出完整 Key；高级配置中的第三方文本模型 Key 目前以明文保存在本机配置文件中，只应在可信电脑上使用且不得随项目归档。
- 远程账号服务默认只接受 HTTPS，只有回环地址允许 HTTP 调试。
- 发行脚本采用白名单构建，并拒绝模型、账号会话、请求、日志和生成结果进入轻量安装包。
- 公网 URL 是互联网入口，请妥善保管 API Key，不要提交到代码仓库或公开截图。