跳到主要内容
AI教程

AIFISHER 画布入门：连接素材、AI 模型与创作流程

本教程将介绍 AIFISHER 画布的核心能力、Windows 源码运行方式、AIFISHER API 配置、素材与模型连接方法，以及本地数据、网络、诊断和非商业许可等注意事项。

AI我搜编辑部阅读约 8 分钟
AIFISHER 画布入门：连接素材、AI 模型与创作流程

认识 AIFISHER 画布

AIFISHER 是一个面向 AI 创作的画布工具，将图片、视频、音频、文字和 AI 工作流放在同一个空间中。你可以在画布上整理灵感与素材、连接模型服务、规划分镜，并保存生成结果，让创作过程从零散操作变成可追踪的工作流。

项目支持连接 AIFISHER API、其他模型服务、本地 ComfyUI 和 RunningHub，也提供 Agent 辅助规划与操作、API 工作流导入和参数配置等能力。项目与素材默认保存在本机，但调用在线模型时，提示词和参考素材会发送给你选择的服务商。

AIFISHER 画布示意图

核心功能概览

  • 多媒体节点：在同一张画布中连接图片、视频、音频和文字节点。
  • 模型服务接入：使用 AIFISHER API，也可以配置其他服务商、本地 ComfyUI 或 RunningHub。
  • 引用与生成：引用已有素材，调整生成参数，并将结果继续连接到后续流程。
  • 创作流程管理：使用 Agent 辅助规划和操作，将灵感、分镜、提示词与结果保留在项目中。
  • 本地项目保存：项目和素材默认保存在本机，源码版工作区位于运行目录的 .desktop-dev/。

安装与运行环境

源码运行需要以下环境：

  • Windows x64
  • Node.js 24.20.0
  • npm
  • 如需本地生成，还要另外安装 ComfyUI
  • 如需使用在线模型，需要准备对应服务商的有效 API Key

视频转码和音频处理等操作还需要可用的 FFmpeg 与 ffprobe。源码快照不附带这些运行时二进制文件，也不会自动安装 ComfyUI 或模型权重。

从源码启动 AIFISHER

先通过 Git 获取项目源码，并在项目根目录打开 PowerShell。随后依次执行依赖安装和桌面开发启动命令：

npm ci
npm --prefix apps/desktop ci
npm run desktop:dev

首次启动时，Electron 桌面运行时会根据 npm 包自带的校验值下载，因此需要保持网络连接。启动后，源码版的本机工作区会保存在 .desktop-dev/ 目录中。这个目录包含本机工作数据，不要将它提交到仓库或分享给其他人。

验证项目状态

完成安装后，可以运行项目检查命令：

npm run check

该命令会执行类型检查、公开范围测试，以及前端和桌面启动页构建。自动测试不会调用付费生成服务，因此不会因为检查流程产生模型调用费用。

配置 AIFISHER API

在线模型服务需要单独注册和配置。请按以下步骤操作：

  1. 打开 AIFISHER API，注册或登录账号。
  2. 在 API 站创建并复制自己的 API Key。
  3. 启动 AIFISHER 画布，进入设置。
  4. 打开闭源服务，选择AIFISHER API。
  5. 粘贴 API Key 并保存。
  6. 回到画布，根据需要选择相应的在线模型服务。

画布账号与 API 站账号分别管理。本地画布无需登录即可使用；在线生成则按照服务商的实际规则计费，软件不附带免费模型额度。建议只通过设置界面保存密钥，不要把真实 API Key 写入示例配置或提交到 Git 仓库。

在画布中组织一次创作

一个基本的工作方式是先导入或创建文字、图片等素材节点，再根据创作目标连接模型服务，最后保存生成结果。你可以把提示词、参考图和参数放在同一条流程中，便于继续迭代。

  1. 建立主题：使用文字节点记录创作目标、角色设定、场景描述或分镜信息。
  2. 加入参考素材：连接图片、视频或音频节点，作为视觉、动作或声音方向的参考。
  3. 连接模型：选择已配置的 AIFISHER API、其他在线服务、ComfyUI 或 RunningHub。
  4. 调整参数：根据模型和服务商提供的选项修改生成参数。
  5. 检查结果：将生成结果保留在画布中，与原始提示词和参考素材一起比较。
  6. 继续迭代：修改提示词、替换参考素材或调整参数，再生成新的版本。

AI 创作流程示意图

项目随画布提供风格与运镜素材库，可用于浏览视觉方向。例如，素材库包含动画风格、生活人像和科幻影像等方向，也提供环绕上升、希区柯克变焦等运镜参考。实际生成效果仍取决于所使用的模型、提示词和参考素材。

连接本地与第三方工作流

使用本地 ComfyUI

如果希望连接本地 ComfyUI，需要先在系统中单独完成 ComfyUI 的安装和运行，再在 AIFISHER 中配置相应连接。遇到 ComfyUI 问题时，反馈中应附上最小可复现的 API JSON，方便定位工作流或参数问题。

使用 RunningHub 或其他服务商

AIFISHER 也支持 RunningHub 和其他模型服务。使用这些服务前，需要准备各自有效的 API Key，并按照服务商的收费、隐私和使用条件进行配置。API 工作流可以导入并继续进行参数配置，但具体可用能力取决于连接的服务。

数据、隐私与诊断注意事项

AIFISHER 默认将项目保存在本机，但“本地画布”不等于所有模型都在本地运行，也不代表素材永远不会上传。当你主动调用在线模型时，相关提示词和参考素材会发送给选定的服务商，请先确认其收费、隐私和内容使用政策。

官方账号与设备身份服务会联网。即使未登录，也可能向官方服务发送设备标识和调用诊断信息。诊断信息包括应用版本、模型与服务商、调用状态、耗时、错误阶段、HTTP 状态、请求或任务标识，以及脱敏后的错误摘要。诊断上报不以收集 API Key、完整提示词或原始素材为目的；提交意见反馈时，主动附加的文件会发送至反馈服务。

进阶使用建议

  • 保护密钥：始终通过设置界面保存 API Key，避免将真实密钥写入配置、日志或示例代码。
  • 管理工作区：不要提交或分享 .desktop-dev/，其中可能包含本机工作数据。
  • 先做小规模验证：使用 npm run check 检查源码环境；自动测试不会调用付费生成。
  • 区分本地与在线模型：在发送参考素材前，确认当前连接的模型服务和数据传输范围。
  • 准备可复现反馈：报告问题时提供版本、复现步骤和脱敏日志，并移除账号、API Key、私人路径和私人素材。
  • 处理媒体依赖：涉及视频转码或音频处理时，确认 FFmpeg 和 ffprobe 可用。

安装版与许可证

如果不需要运行源码，可以前往 版本发布页面，或访问官方下载网盘获取安装版。已安装的正式版会继续接收官方签名自动更新。

项目源码仅限非商业用途。允许非商业学习、研究、修改和免费再分发，但禁止接单、商业制作、倒卖安装包、商业二次开发或收费托管。项目使用 AIFISHER Noncommercial Source License 1.0，不属于 OSI 定义的开源许可。第三方组件遵循其原有许可，闭源 SKILL、私有共享模板、个人账户和密钥不在公开范围内。

使用 AIFISHER 前，请阅读仓库中的 LICENSE、SOURCE-SCOPE.md 和 THIRD-PARTY-NOTICES.md，并确认你的使用方式符合许可条款。

总结

AIFISHER 画布适合将多媒体素材、提示词、模型服务和 AI 创作步骤集中管理。入门时可以先在 Windows 环境完成源码或安装版部署，再通过设置配置 API Key，随后从文字和参考素材节点开始构建工作流。使用在线模型时，要特别关注费用、隐私、密钥保护和非商业许可边界。