用途：为编码智能体提供按需媒体生成能力，调用 https://api.higgsfield.ai，在用户当前项目内工作。它是本地智能体工具，不是 Web 应用或多用户后端，需保留用户选择的 API、模型与输出。
主要能力：按任务类型（图片、文生视频、图生视频、参考生视频、编辑）只发现所需模型；未指定视频时建议 Seedance 2.5，单个 5 秒 720p 片段，若给出时长则按用户要求。从共享文档索引与模型目录入手，跟随所选模型的 API 参考及其 llms.txt。首次使用某模型时读取其参考，核对生产端点、输入 JSON Schema、必需媒体角色、时长/分辨率选项、输出结构与定价。
使用方式：凭据只放环境变量，不得写入技能文件、请求 JSON、版本控制、命令参数、日志或输出。将模型输入写入项目 work/higgsfield/ 下的 JSON，再运行 validate 与 estimate，使用账户专属估价而非促销价或硬编码每秒价格。提交时用稳定的描述性 --job；默认省略预算标志，仅在用户明确要求上限时同时传 --budget-id 与 --budget-usd。辅助脚本在 POST 前把估价与任务记入本地 SQLite 账本，拒绝重复付费提交，且不自动重试生成 POST。用 status/wait 查询已知 ID，wait 采用退避与总截止时间；完成后用 download 保存到项目 outputs/，确认文件存在并检查结果。
限制：文档与缓存不一致时，先从实时参考更新项目副本，未解决则停止，不猜测端点、不降级模型、不切换预览环境。区分文档可用性与账户已确认的访问权限。超时可能意味着提供方已接受任务，不要另起生成来消除不确定性。该技能不使用旧版 higgsfield CLI，不为每次请求加载全部模型文档，不建网站、不常驻服务器、不为一次性本地任务配置 webhook。模型差异放在 profile schema 与参考中，通用机制放在 scripts/higgsfield_api.py。其他模型需按发现流程保存带日期的 profile 到 work/higgsfield/models/，不要覆盖已安装技能文件。安装技能或仅请求建议不构成付费生成授权。