Higgsfield 发布 CLI 使用指南：终端与编码代理可调用同账号积分生成图文视频，无需 API Key
Higgsfield 于 2026 年 10 月 19 日发布 CLI 官方指南：可用 curl、Homebrew 或 npm 安装，浏览器登录普通账号即可在终端生成图片与视频，扣同一套计划积分；支持先查价、图生视频、Soul ID、批量脚本，并说明 CLI / MCP / 独立 API 的计费差异。网页端 Unlimited 与免费额度不适用于 CLI。
据 Higgsfield 2026 年 10 月 19 日官方博客，该公司整理了 Higgsfield CLI 的完整用法：在终端、脚本或编码代理里调用与网页端相同的模型目录，素材仍进同一 Assets 库。命令名为 higgsfield（短别名 higgs），开源仓库在 GitHub。
按官方说明，这次指南的核心点包括：
- 安装与登录：支持 curl（macOS/Linux）、Homebrew，或
npm install -g @higgsfield/cli；运行higgsfield auth login走浏览器授权，不需要 API Key；本地保存短时令牌，过期再登录； - 计费：生成按计划积分、标准费率扣除；网页端 Unlimited 与免费次数不适用于 CLI；另有独立的 Higgsfield API（需 open.higgsfield.ai 的 Key、美元预付余额），与 CLI/MCP 的账号积分池分开；
- 生成流程：
generate create <model_id>出图/出视频；--wait等待完成，--json方便脚本解析；可用上一张图的 job id 作--start-image做图生视频（如 Seedance 2.5 需--mode omni_reference）； - 先查价再跑：
generate cost用相同参数只打印积分、不创建任务；官方实测示例中，Seedance 2.5 约 5 秒 1080p 全量渲染约 80 积分，同设置--draft true约 15 积分（以账号当日cost回执为准）； - 角色与批量：
soul-id create最多约 20 张参考图训练角色，再在兼容模型里复用；无提示词文件循环create（不加--wait）可批量拿 job id，再generate wait收结果； - 代理接入：Claude Code、Codex、OpenClaw、Hermes 等可通过 CLI + Skills；Cursor 亦支持；网页端 Claude 走 MCP，ChatGPT 走官方 Plugin。指南命令以 CLI 1.1.26（约 2026-10-16）验证，模型 id 与价格会变，应以
model list/generate cost为准。
对创作者意味着什么： 若你已经在用 Higgsfield 做广告素材或短剧镜头，CLI 适合把「提示词列表 → 批量出片 → 收回链」嵌进本地脚本或编码代理，少开网页点选。注意 CLI 会实扣积分，大批量前务必 generate cost，并确认当前订阅是否划算；偏手工、依赖网页 Unlimited 的用户继续用网站可能更省。令牌等同登录态，不要贴进聊天、截图或仓库。涉及真人肖像与品牌素材时，仍须确认授权后再商用或投稿。
信息来源：Higgsfield 官方博客（本文为编辑整理改写）
