跳到主要内容
AI教程

使用 OpenHiggsfield AI 搭建并运行开源 AI 图像与视频工作室

学习安装 OpenHiggsfield AI、连接平台密钥、生成和管理媒体，并了解其目录驱动的 Next.js 架构。

AI我搜编辑部阅读约 10 分钟
OpenHiggsfield AI 图像与视频工作室

什么是 OpenHiggsfield AI？

OpenHiggsfield AI 是 Higgsfield AI 的免费开源替代方案。它提供统一的浏览器工作室，可使用 40 个模型生成图像和视频，其中包括 12 个图像模型和 28 个视频模型。你可以使用自己的生成平台密钥，并选择打开托管工作室或自行运行该应用。

该项目基于 Next.js 16 App Router、React 19、Zustand、原生 CSS 和 pnpm 构建。其目录包含来自 Nano Banana、Soul、Gemini、Kling、Veo、Wan、Flux、GPT Image、Ideogram、Recraft、LTX、MiniMax、PixVerse、Grok 和 Qwen 等系列的模型。

该工作室免费且开源，但生成请求会使用你自己的平台密钥。

主要功能

使用同一个编辑器生成图像和视频

同一个提示词输入栏可处理图像和视频生成。所选模型决定输出类型。在 macOS 上按 Cmd + Enter，在其他平台上按 Ctrl + Enter 即可提交请求。

每个模型都会声明其支持的设置和媒体角色。因此，界面只会显示相关控件，例如宽高比、分辨率、时长、输出格式、音频、批量数量和提示词增强。

模型感知型媒体输入

根据所选模型，你可以添加其支持的输入，例如起始帧、结束帧、参考媒体、视频或音频。每种角色均遵循该模型声明的限制。

上传的文件会直接发送至 Vercel Blob，并转换为生成请求可使用的公开 URL。资源选择器还可以复用上传库中的文件，或本地历史记录中已完成的生成结果。

批量生成与实时进度

该工作室每次提交最多支持四个结果。具有原生数量设置的模型会使用该选项；其他模型则会为每个结果分别发送一次请求。

提交后会立即显示结果占位符。OpenHiggsfield AI 每四秒轮询一次请求状态，超时时限为十分钟，并在每个结果可用后立即显示。

图库与结果管理

  • 四种图库范围：图像、视频、资源和收藏。
  • 瀑布流布局：结果按实际宽高比显示，并按最新优先排序。
  • 卡片操作：复用、收藏、删除和选择单个结果。
  • 详细查看器：检查提示词、模型、最终设置、时间戳和全尺寸媒体。
  • 批量操作：下载、收藏、取消收藏或删除所选项目。
  • 撤销：删除后的结果可在六秒内恢复。
  • 失败恢复：失败、取消或 NSFW 的运行会保留失败原因，并提供重试流程。

选择复用会恢复原始模型、提示词和设置，因此它不仅是复制提示词文本，更适合迭代式创作。

本地历史记录

历史记录存储在当前浏览器的 IndexedDB 中。系统最多保留 60 条记录，而收藏项目不会因达到该上限而被淘汰。由于结果 URL 属于生成平台，因此即使其 CDN 媒体已过期，较早的记录仍可能保留在历史记录中。

方案一：使用托管工作室

最快的开始方式是打开 openhiggsfield.ai。该版本完全在浏览器中运行，无需安装 Node.js，也无需进行本地设置。

  1. 打开托管工作室。
  2. 选择添加密钥。
  3. 以 id:secret 格式粘贴平台密钥。
  4. 选择一个图像或视频模型。
  5. 输入提示词并配置可用设置。
  6. 提交请求，等待结果卡片生成完毕。

密钥由服务器操作处理，并存储在 httpOnly Cookie 中。浏览器不会直接调用生成 API。如果没有可用密钥，工作室会打开密钥输入对话框，而不是静默失败。

方案二：在本地安装 OpenHiggsfield AI

前置条件

你需要一个能够通过 pnpm 运行该项目的开发环境，还需要一个兼容的生成平台密钥。上传工作流则需要 Vercel Blob 读写令牌。

安装依赖并启动开发服务器

克隆或下载代码仓库，在终端中打开其目录，然后运行：

pnpm install
pnpm dev

开发服务器会在 http://localhost:3000 启动。打开该地址，点击添加密钥，然后以 id:secret 格式输入密钥。

配置环境变量

在应用使用的环境中设置生成 API 源地址和 Vercel Blob 令牌：

HF_API_BASE_URL=
OPEN_HIGGSFIELD_READ_WRITE_TOKEN=
  • HF_API_BASE_URL 用于定义仅服务器可访问的生成 API 源地址。
  • OPEN_HIGGSFIELD_READ_WRITE_TOKEN 提供 Vercel Blob 上传所需的读写权限。

不要通过客户端代码暴露生成 API 源地址或私密凭据。该项目的设计确保只有服务器操作能够调用生成 API。

生产环境命令

使用以下命令构建并运行生产版本：

pnpm build
pnpm start

代码仓库还提供一个品牌资源命令，用于重新构建 public/ 中的图标和 Open Graph 卡片：

pnpm brand

生成第一个结果

  1. 确认顶部栏的密钥指示器显示已有可用密钥。
  2. 打开支持搜索的模型选择器。
  3. 选择一个图像或视频模型。
  4. 在共享编辑器中输入提示词。
  5. 检查针对该模型呈现的设置。
  6. 如果模型支持，请添加参考媒体或其他特定角色的输入。
  7. 在适用情况下，选择最多为四的批量数量。
  8. 按 Cmd + Enter 或 Ctrl + Enter。

对于基本图像请求，可以输入：

一座位于晨曦薄雾森林上方的玻璃天文台，电影感摄影

对于视频模型，可以使用强调运动效果的提示词：

镜头缓缓接近一座玻璃天文台，晨雾在树林间流动

可用选项因模型而异。请仅使用工作室显示的设置和媒体角色，不要假定所有模型都支持相同的输入。

复用资源和以往的生成结果

当模型接受媒体输入时，请打开相应角色的资源选择器。它会在同一个资源库中提供两个来源：

  • 上传：此前通过工作室上传的文件。
  • 历史记录：已完成生成任务中的媒体。

选择器会根据所选角色要求的媒体类型筛选项目。因此，当选定模型声明支持相应输入时，你可以将生成完成的图像用作起始帧或参考图。

若要重复之前的生成任务，请在其图库卡片上选择复用，或在查看器中选择重新创建。工作室会恢复模型、设置和提示词，让你可以只修改一处细节并生成另一个版本。

在图库中高效工作

使用“图像”和“视频”范围专注于特定媒体类型，使用“资源”查看所有已完成的运行，并通过“收藏”快速访问重要输出。标签栏支持使用方向键导航。

如需管理多个结果，请点击卡片复选框进入选择模式。按住 Shift 点击可扩展选中范围。随后，你可以执行批量下载、收藏状态变更或删除操作。按 Esc 可退出选择模式。

批量下载会按顺序执行并显示进度。最终报告会列出被 CDN 拒绝的文件。如果误删了项目，请在六秒倒计时结束前使用撤销功能。

生成架构的工作原理

每次生成都始于一个对象，其中包含所选模型、提示词、媒体和设置：

{ model, prompt, media, settings }

界面会构建该对象并将其传递给服务器操作。该操作根据目录解析模型，并将工作室中的值映射为生成 API 所需的字段，例如 image_urls 和 aspect_ratio。

提交和状态请求遵循以下服务器端模式：

POST /{model}
GET /requests/{id}/status
Authorization: Key <api_key>

浏览器绝不会直接连接生成 API。上传由单独流程处理：客户端通过 /api/blob 上传至 Vercel Blob，该端点会签发限定范围的令牌。本地 blob: URL 仅用于预览。

项目结构

src/
  app/
    /api/blob
    base.css
  generation/
  openhiggsfield/
  • src/app/ 包含全视口工作室页面、Blob 令牌端点和文档级画布样式。
  • src/generation/ 包含生成请求、服务器操作、API 映射、模型目录和 Zustand Store。
  • src/openhiggsfield/ 包含编辑器、图库、查看器、模型选择器、设置、资源选择器、选择栏和工作室 CSS。

高级技巧

将目录作为唯一可信来源

模型行为由 src/generation/catalog/ 下的目录驱动。每个目录条目都会向界面提供其设置和媒体角色，因此工作室无需维护单独的硬编码控件列表。

使用生成服务支持的模型扩展项目时，请遵循现有的目录声明模式。确保其允许的设置和媒体角色准确反映 API，而不是在工作室的其他位置添加特定于模型的控件。

让 API 访问保留在服务器端

自定义项目时，请保留现有的服务器操作边界。生成身份验证使用 Authorization: Key <api_key>，将这些调用移入浏览器代码会破坏把 API 通信和凭据保留在服务器端的设计。

了解 Zustand 状态模型

该应用使用五个小型 Zustand Store，而不是为每个模型创建一个 Store。图像和视频工作流共享提示词与媒体状态，设置按模型 ID 建立索引，另有一个小型活动 Store 用于跟踪当前状态。自定义时应保留这种面向模型的设置结构。

为媒体 URL 过期做好准备

IndexedDB 历史记录的保留时间可能超过生成平台 CDN 上托管文件的有效期。收藏记录会被特意保留，但这并不保证其远程媒体 URL 始终可用。请下载重要输出，不要只依赖浏览器历史记录。

在长时间迭代中使用收藏功能

常规历史记录上限为 60 条，而收藏项目不会因该上限而被淘汰。在长时间创作过程中，将有潜力的输出标记为收藏，然后使用“复用”或“重新创建”继续优化其提示词和设置。

总结

OpenHiggsfield AI 将图像和视频生成整合到一个开源、目录驱动的工作室中。你可以立即使用托管版本，也可以自行托管 Next.js 应用，连接自己的密钥，使用模型专属控件、复用资源，并通过持久化浏览器图库管理结果。其仅限服务器端的 API 边界和声明式目录也为自定义提供了清晰基础。