用途:作为营销图片与 AI 视频生成的单一入口,所有生成经由 Higgsfield CLI,用一个账号使用模型目录(gpt_image_2、FLUX 系列、电影感/视频模型)。默认图片模型为 gpt_image_2,文本与字标还原较强。
主要能力:文生图、以参考图生成(--image,用于实物照片/设计参考的合成与人物保持)、AI 视频片段(先查视频模型目录)。变体默认多张生成:每个用途至少 3 张(构图/色调/概念不同),广告素材需 4 张以上(钩子轴 × 视觉轴),单张生成视为违规。生成后需逐张目视校验,检查图中文字、手指/logo 变形与品牌色;以文字为核心的图默认不烧字,改用 HTML/PIL 叠加(YouTube 缩略图例外)。真实人物只能用用户提供的照片作参考,不得虚构人脸。
使用方式:一次性安装 npm i -g @higgsfield/cli,然后 higgsfield auth login、higgsfield account status 核对邮箱与额度、higgsfield model list --image 查看目录。生成示例:higgsfield generate create gpt_image_2 --prompt "<场景描述>" --aspect_ratio 16:9 --quality high --resolution 2k --wait --json;带参考图时加 --image ./reference.png。输出为 pretty-print JSON,需对 stdout 整体 json.loads 后递归收集图片 URL,排除输入参考图所在主机;保存文件带 BOM(encoding='utf-8-sig'),下载用 Python urllib.request.urlretrieve。临时 502 只重试一次,反复失败需报告。Windows 下 CLI 用完整路径 %APPDATA%\npm\higgsfield.cmd。
适用场景与规格:新闻稿头图 16:9(缩至 1200 宽,3 张,无文字视觉,标题放邮件 HTML);博客封面 16:9(3 张,兼顾 OG 1200×630 裁切);广告素材 1:1/16:9(4 张以上,A/B 必需);卡片新闻背景 4:5(2–3 张,提示词留出文字区);样机合成(2 张以上,--image 输入真实设计并注明 EXACTLY 保留)。
限制:Higgsfield 是唯一生成路径,直接 API 仅在其不可用的环境使用且须告知用户;生成前必须核对账号,错误账号的支出不可撤回;不得在失败时静默切换模型,需报告并由用户决定;参考图保真合成需在提示词写明 reproduce EXACTLY as provided, same layout/text/colors, no redesign,且小字仍为近似,正本以原文件为准;视频编辑/合成流程由 ad-video、hyperframes 负责。附录直接 API:OpenAI gpt-image-2 用 POST /v1/images/generations(env OPENAI_API_KEY,billing_hard_limit_reached 表示额度耗尽),编辑用 /v1/images/edits;Google Nano Banana 用 Gemini generateContent 加 inline_data 图片输入(env GEMINI_API_KEY),两者均须先告知用户。