Higgsfield 核心是 moai-cowork 中图像、视频等 Higgsfield 技能的共享参考核心(SSOT,仅作引用)。图像与视频两个消费技能从此处获取调用契约、查询顺序与通用规则。核心设计原则是:模型 id、枚举、aspect、duration、media role、费用等参数绝不硬编码,全部在运行时通过 models_explore 等工具查询;只有提示词撰写(prompt craft)静态整理并标注来源。
主要能力与用法:核心自身不生成内容,而是为消费技能提供契约与参考文件,包括 references/call-schema.md(嵌套 params{} 调用形态、medias[].role/.value 规则、namespace 运行时解析、不存在的参数反模式)、references/catalog-protocol.md(models_explore 等实时查询工具与标准顺序 REQ-010)、references/universal-rules.md(R1–R5 跨供应商通用规则)、references/interview-schema.md(收集槽位)、references/job-lifecycle.md(get_cost 预检、credits 规则、adjustments 回读、轮询与错误分类、余额停止)。
编排契约(REQ-010):意图、缩小候选,仅缩小候选而不断定参数;用 models_explore(action:'get') 实时查询限制,Marketing Studio 系列用 show_marketing_studio;用 get_cost: true 预检 credits;进入审批门槛;按批准值生成;用 job_status 轮询至 completed 并回报 adjustments。
付费生成审批门槛:关键规则是消耗 credits 的调用前必须获得批准,预检与查询类工具不在此列。批准前要展示提示词全文、模型 id 与系列、输入媒体及 role、查询确定的选项、生成数量、服务端改动的 adjustments、以及 get_cost 给出的预估 credits 与当前余额。选项为“按此生成(推荐)/ 修改后重新估价 / 取消”。生成失败时不新建任务,先查已有 job ID 状态,无 ID 再确认是否有查询工具,否则请用户在 Higgsfield 面板确认。批量任务按批整体批准,超出计划的生成需重新批准。
限制与边界:技能与子代理不直接向用户提问,只记录收集槽位,实际提问由编排器完成;槽位为空时返回结构化 blocker。审批请求契约与具体工具名无关,按运行时结构化工具有无、通用对话或返回 blocker 三种路径获取批准;运行时工具执行权限提示不算批准。完全无法询问的无人执行场景下采取 fail-closed,停止不执行。namespace 前缀需在调用前按运行时实际暴露确认,不硬编码。