Higgsfield CLI

Overview

GitHubGitHub

Higgsfield CLI 是一款基于 Shell 编写的命令行工具，允许开发者直接在终端中调用 Higgsfield AI 平台的 40 多个模型，完成图像、视频、3D 资产与音频的生成任务。 该工具将多模态 AI 生成能力封装为标准化的 CLI 命令，用户无需离开终端环境即可执行复杂的媒体生产流程。支持的模型包括 Nano Banana Pro、FLUX.2、GPT Image 2.5、Kling v3.0、Seedance 2.5、Gemini Omni Flash、Veo 3.1 等。 ### 主要能力 - **多模态生成**：支持 23 个图像模型和 22 个视频模型（原文截断前可见部分），以及音频和 3D 动画相关功能。 - **工作流编排**：内置 Draw To Video、Reframe、Voice Change、Dubbing 等工作流命令，可对已有视频进行画面编辑、比例重构、声音替换和多语言配音。 - **Soul ID 角色训练**：通过上传多张人物图片训练 Soul ID，随后在兼容的图像模型中复用该角色，生成面部一致的图片。 - **Virality Predictor**：使用 `brain_activity` 任务类型对已完成的视频进行分析，输出关于吸引力、注意力、留存率和传播潜力的评分及报告链接。 - **Video Explainer**：提供分步构建解说视频的技能，结合 Seed Audio 生成旁白、Gemini Omni 生成画面，最终组装为完整视频。 - **游戏部署**：支持将包含 `index.html` 的浏览器游戏 ZIP 包部署并发布到平台。 ### 安装方式 支持 macOS/Linux 下的 curl 脚本和 Homebrew 安装，跨平台（含 Windows）可通过 npm 全局安装，也支持手动下载二进制文件放入 `$PATH`。 适合需要在自动化脚本、CI/CD 流程或纯终端环境中批量调用 AI 媒体生成能力的开发者和内容创作者。项目采用 MIT 协议开源。

Q&A

如何安装 Higgsfield CLI？AI-generated

macOS/Linux 可使用 curl 脚本或 Homebrew 安装；跨平台（含 Windows）可使用 npm install -g @higgsfield/cli；也可从 Releases 页面手动下载对应系统的二进制文件放入 $PATH。

使用前需要认证吗？AI-generated

需要。安装完成后需运行 higgsfield auth login 命令进行身份验证。

如何生成一张图片？AI-generated

使用 higgsfield generate create 命令，指定模型名称（如 nano_banana_2）、--prompt 提示词，并加上 --wait 等待结果 URL 返回。

支持哪些类型的模型？AI-generated

支持 40 多个模型，涵盖图像（23 个）、视频（22 个）、3D 和音频。具体列表可通过 higgsfield model list 查看。

什么是 Soul ID？AI-generated

Soul ID 是一种角色训练功能。通过 higgsfield soul-id create 上传多张人物图片训练后，可在 text2image_soul_v2 等兼容模型中通过 --soul-id 参数复用该角色。

Virality Predictor 是做什么的？AI-generated

其技术任务类型为 brain_activity，用于分析已完成视频的 hook 强度、注意力、留存率和传播潜力，输出评分并提供 Open report 链接。

如何将视频配音为其他语言？AI-generated

使用 higgsfield generate workflow dubbing 命令，传入 --video 源文件路径和 --target_language 目标语言的 ISO-639-3 代码（如 spa）。

如何部署一个浏览器游戏？AI-generated

准备一个根目录包含 index.html 及 logic.js 或 server.js 的 ZIP 包，运行 higgsfield game deploy ./game.zip 并指定标题和描述等参数。