higgsfield-ai/cli

Higgsfield CLI – 从终端生成 AI 内容

是什么 – 一个跨平台命令行工具，可直接从你的 shell 调用 40 多个 Higgsfield AI 模型（图像、视频、3D、音频）。它处理认证、任务提交、成本估算和结果获取，并且还能在不离开终端的情况下创建全栈 React 基础的 Web 应用或发布浏览器游戏。

安装方法

• macOS/Linux：一行命令 curl … | sh
• Homebrew tap（brew install higgsfield-ai/tap/higgsfield）
• 任意平台：npm（npm install -g @higgsfield/cli）
• 手动下载预构建二进制文件。

典型工作流

1. higgsfield auth login – 存储你的 API 密钥。
2. 创建任务，例如 higgsfield generate create nano_banana_2 --prompt "a quiet beach at sunrise" --wait。
3. CLI 会轮询服务，当资产准备就绪时输出 URL（或使用 --json 输出 JSON）。

核心功能

领域	你可以在 CLI 中完成的操作
图像	使用 Nano Banana Pro、FLUX.2、GPT-Image 2.5、Soul V2 等模型进行图像生成、放大、外补、背景移除、风格迁移。
视频	文本生成视频、风格引导剪辑、重构、语音更换、配音、病毒性分析（Virality Predictor），使用 Seedance 2.5、Kling v3.0、Gemini Omni 等模型。
3D 资产	将多图像集或文本提示转换为 3D 网格、骨骼绑定或 Tripo 风格资产。
音频	文本转语音（ElevenLabs、Minimax 等）、音乐生成、语音替换。
工作流	高级流水线（绘图转视频、重构、语音更换、配音），可组合多个模型调用。
网站	生成 React 19 + TanStack Start 应用，通过临时 git 令牌推送代码，并以 Cloudflare Worker 支持的站点部署。可选择模板（app-detail、preset、studio）或普通网站。
游戏	上传包含浏览器游戏的 ZIP 文件并发布到 Higgsfield 市场。
Soul ID	通过几张照片训练个人“Soul”角色，并用于面部忠实的图像生成。
成本估算	higgsfield generate cost … 预测给定模型或工作流所需的积分。
账户与工作区	查看积分余额、交易历史，并切换计费工作区。

模型目录 – higgsfield model list 命令可列出全部 40 多个模型。分为图像（23）、视频（22）、3D（5）和音频（5）。每个模型都有其独立的 job_set_type（如 nano_banana_2、seedance_2_5、text2speech_v2），并附有 MODELS.md 中记录的参数说明。

示例命令

# 简单图像生成
higgsfield generate create gpt_image_2_5 \
  --prompt "clean infographic showing global energy mix" \
  --aspect_ratio 3:4 --quality high --resolution 2k --wait

# 带配音的视频
higgsfield generate workflow dubbing \
  --video ./ad.mp4 --target_language spa --wait

# 部署全栈应用
higgsfield website create \
  --type app --category ads-marketing --template studio --subdomain my-ads
# 克隆、编辑、推送，然后部署
higgsfield website repo-access <id>
# …git work…
higgsfield website deploy <id>

为何重要 – 通过轻量级 CLI 暴露丰富的生成式 AI 服务，Higgsfield CLI 使得脚本化内容流水线、将 AI 资产集成到 CI/CD 中，或在不编写任何 HTTP 客户端代码的情况下快速原型开发变得轻而易举。它还集成了 Web 应用搭建和市场游戏发布的端到端工具，使单一二进制文件即可成为完整的创意生产工作站。

许可证 – 开源，遵循仓库中的 LICENSE 文件（见 LICENSE）。