跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Higgsfield，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 用你自己的 API 密钥在 Higgsfield 上生成图片和视频：SOUL 人像，Marketing Studio 和 Ads Studio 产品图，Seedance、Kling 3.0 和 Cinema Studio 视频，以及另外 80 多个模型，每次运行前先估算价格，并可查询状态和取消。
试试这样问
Higgsfield 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Higgsfield、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Higgsfield
让你的 AI 用你自己的 API 密钥在 Higgsfield 上生成图片和视频：SOUL 人像，Marketing Studio 和 Ads Studio 产品图，Seedance、Kling 3.0 和 Cinema Studio 视频，以及另外 80 多个模型，每次运行前先估算价格，并可查询状态和取消。
设置
设置大约需要 3 分钟。你需要一个有 API 额度的 Higgsfield Console 账户和一个 API 密钥。每次生成都从这个余额中扣费。
- 登录 https://console.higgsfield.ai 并充值 API 余额（按量付费）。没有额度时，生成请求会被 403 拒绝。
- 在 Console 中打开 API keys 并创建一个密钥。它由两部分组成：key ID 和 secret。secret 只显示一次，请立即复制。
- 把 key ID 粘贴到
HIGGSFIELD_API_KEY_ID，把 secret 粘贴到HIGGSFIELD_API_KEY_SECRET，分别单独填写，不要加冒号或 Key 一词。连接器会把两者拼成请求头Authorization: Key <id>:<secret>，并且只发送给 api.higgsfield.ai。 - 安装连接器。安装时会通过列出 SOUL 风格来检查密钥，这不收费；你也可以随时用
higgsfield_list_soul_styles重复这项检查。
可以生成的内容：图片方面有 SOUL V2（写实人像、时尚和杂志风格，可选用某个 SOUL 风格或你训练好的 Soul ID 角色）、Marketing Studio（广告活动图和产品图，最多用 16 张参考图编辑，或基于预设生成广告）和 Ads Studio（根据一份简报和可选的产品照片生成 1 到 8 个广告创意）。视频方面有 Seedance 2.5（文生视频、图生视频或参考素材生成视频）、Kling 3.0（Standard、Pro 或 4K 档位，带原生音效）和 Cinema Studio 4.0。其余 80 多个模型，例如 Wan、MiniMax、Hailuo、Grok Imagine、Recraft 或 Ideogram，可以用 higgsfield_generate 加上 docs.higgsfield.ai 模型页面上的端点 ID 来运行。
免费读取的内容：请求的状态和输出、价格估算、SOUL 风格、Marketing Studio 预设，以及你的 Soul ID 角色及其训练状态。
每次生成都会消耗额度，所以 AI 会先估价再询问：在调用 higgsfield_soul_image、higgsfield_marketing_studio_image、higgsfield_ads_studio、higgsfield_seedance_text_to_video、higgsfield_seedance_image_to_video、higgsfield_seedance_reference_to_video、higgsfield_kling_text_to_video、higgsfield_kling_image_to_video、higgsfield_cinema_studio_video 或 higgsfield_generate 之前，AI 会用相同的模型和输入运行 higgsfield_estimate_cost，告诉你将使用哪个模型、要花多少，并等你同意。它从不在未询问的情况下循环启动多个生成任务。视频比图片贵得多，并随时长、分辨率和档位上涨；一次批量生成 4 张图片的费用大约是 1 张的四倍。失败的请求和被内容审核拒绝的请求（nsfw）不收费。调用 higgsfield_cancel_request 前 AI 也会先询问。
安装时关闭：没有。每个付费工具都要经过价格估算和你的确认，而取消只对尚未开始的请求有效。
从请求到结果：生成请求会立即返回一个 request_id 和状态 queued。AI 每 5 到 10 秒用 higgsfield_get_request_status 查询一次；图片只需几秒，视频通常需要几分钟。你拿到的是图片、视频或音频的链接，而不是文件。链接至少保留七天，想保存的内容请及时下载。只有仍在排队的请求可以取消，取消后额度会退回；已经开始处理的请求会在完成时扣费。超时后用同一个 idempotency_key 重试，会返回原来的请求，而不是再扣费生成第二次。
输入是链接：参考图片、视频和音频都以公开的 HTTPS URL 传入。连接器无法从你的电脑上传文件。
限制：主要限制是并发数，即同时排队或运行的请求数量（通常为 4）。如果返回 400，提示已达到最大并发请求数，就需要等其中一个完成。你账户的限制显示在 Console 中。
常见错误：401 Invalid credentials 表示 key ID 或 secret 错误、填反或已被撤销：请在 Console 中创建新密钥。403 表示额度不足。404 表示请求 ID 不存在或属于其他账户，或者你的账户无法使用该模型。422 表示某个输入字段缺失、拼写错误或超出范围，错误信息会指明是哪个字段。423 或 503 表示模型暂时被锁定或停用：稍后再试或换一个模型。
这个连接器不会上传文件、接收 Webhook、训练 Soul ID 角色、使用 Agent API，也看不到 Higgsfield 网页应用里的项目和历史记录。
前提条件: HIGGSFIELD_API_KEY_ID, HIGGSFIELD_API_KEY_SECRET
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 Higgsfield 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
higgsfield_get_request_status | Get the status and output of a Higgsfield generation request: status (queued, in_progress, completed, failed, nsfw, canceled), error, and… |
higgsfield_cancel_request | Cancel a Higgsfield generation request that is still queued; its reserved credits are refunded |
higgsfield_estimate_cost | Estimate what a Higgsfield generation would cost before running it: send the model's endpoint ID and the same input you would generate… |
higgsfield_generate | Run any Higgsfield model by its endpoint ID with the model's own JSON input: use it for the models without a dedicated tool here (SOUL… |
higgsfield_list_soul_styles | List the SOUL V2 image styles with id, name, description and preview_url |
higgsfield_list_marketing_presets | List Marketing Studio image presets (id, type, name, cover image, aspect ratio and group) |
higgsfield_list_soul_ids | List the account's Soul ID characters (trained character references) with id, name, model_version (v1, v2 or cinema) and status (not_ready… |
higgsfield_get_soul_id | Get one Soul ID character by id: name, model_version, status (not_ready, queued, in_progress, completed, failed), thumbnail_url, created_at… |
higgsfield_soul_image | Generate photorealistic images with Higgsfield SOUL V2 (portraits, fashion, editorial), optionally in a SOUL style… |
higgsfield_marketing_studio_image | Generate or edit campaign and product images with Higgsfield Marketing Studio: text to image without image_urls, editing with up to 16… |
higgsfield_ads_studio | Turn a marketing brief and optional product images into 1 to 8 ad concepts, each rendered as one image (Higgsfield Ads Studio, fixed 2k… |
higgsfield_seedance_text_to_video | Generate a video from text with ByteDance Seedance 2.5 on Higgsfield, with optional generated audio |
higgsfield_seedance_image_to_video | Animate an image into a video with ByteDance Seedance 2.5 on Higgsfield: image_url is the first frame, end_image_url an optional last… |
higgsfield_seedance_reference_to_video | Generate a video with ByteDance Seedance 2.5 on Higgsfield guided by reference media: images (up to 30), videos (up to 10) and audio (up to… |
higgsfield_kling_text_to_video | Generate a video from text with Kling 3.0 on Higgsfield, in the Standard, Pro or 4K tier, with native sound and optional multi-shot… |
higgsfield_kling_image_to_video | Animate an image into a video with Kling 3.0 on Higgsfield, in the Standard, Pro or 4K tier: image_url is the first frame, last_image_url… |
higgsfield_cinema_studio_video | Create a cinematic video shot with Higgsfield Cinema Studio 4.0: text to video, or reference to video when image, video or audio references… |
示例提示
- “用 SOUL 生成一张写实人像：一位穿亚麻西装的女士站在黄金时刻的屋顶上。开始前先告诉我价格。”
- “这是我们新款跑鞋的照片：https://example.com/shoe.jpg。帮我做 4 个用于 Instagram 推广的广告创意。”
- “用 Kling 3.0 Pro 做一段短视频：咖啡师用慢动作拉花。要花多少？”
- “用 Seedance 把这张产品图做成一段短视频：https://example.com/bottle.jpg。先给我看估价。”
- “我上一个视频做好了吗？把链接发给我，我要下载。”
下一步
这份指南对你有帮助吗?
