otherapi_key

Higgsfield

Higgsfield AI provides asynchronous image and video generation APIs powered by multiple creative AI models.

Verdict

Higgsfield brings AI image and video generation into your workspace. @mention it to create visuals from text prompts, train custom character references your team can reuse, or turn static images into short video clips. The MCP exposes twelve tools covering text-to-image (Soul Standard and V2), image-reference workflows (Popcorn), and text-to-video (Seedance 2.0). Designers and content teams get the most value — you can iterate on concepts, test visual directions, or produce social assets without leaving a Project. All requests are asynchronous: you submit a prompt, poll for status, then retrieve the final URL. You'll need an API key and credits in your Higgsfield account; generation costs vary by model and resolution.

Common use cases

  • Prototype hero images for landing pages
  • Generate social media visuals on demand
  • Train brand character references once, reuse everywhere
  • Turn product shots into short promo clips
  • Explore visual concepts during creative reviews

Integration

Vendor
Higgsfield
Category
other
Auth
API_KEY
Tools
12
Composio slug
higgsfield

Tools

  • Cancel Request

    Cancel a Higgsfield generation request while it is still queued; requests already processing or finished cannot be canceled.

  • Create Character Reference

    Start training a reusable Higgsfield Soul ID character reference from one or more public images. Poll GET_CHARACTER_REFERENCE with the returned ID.

  • Estimate Soul V2 Cost

    Estimate the authenticated account's credit and USD cost for a fixed Higgsfield Soul V2 Standard image request without starting generation.

  • Generate Content (Deprecated)

    Deprecated fallback for model routes without typed tools; returns a request ID for status polling. Prefer typed generation actions.

  • Generate Image

    Submit a text-to-image request to Higgsfield Soul Standard and return the request ID used to track the asynchronous result.

  • Generate Image With References

    Submit a Higgsfield Popcorn request that uses one or more reference images and return the request ID used to track the asynchronous result.

  • Generate Seedance 2 Text Video

    Submit a ByteDance Seedance 2.0 text-to-video request through Higgsfield and return the request handle used to track the asynchronous result.

  • Generate Soul V2 Image

    Submit a text-to-image request to Higgsfield Soul V2 and return the request ID used to track the asynchronous result.

  • Generate Video From Image

    Generate a video from a publicly accessible starting image with Higgsfield DOP Lite and return the request ID used to track the asynchronous result.

  • Get Character Reference

    Get a Higgsfield Soul ID character reference and its current training status by ID.

  • Get Request Status

    Get the current state of a Higgsfield generation request and return generated image, video, or audio URLs when complete.

  • List SOUL V2 Styles

    List the SOUL V2 image styles available to the authenticated Higgsfield account, including the style IDs accepted by SOUL V2 generation requests.

Setup

Setup guide

  1. 11. Open your Switchy workspace settings and navigate to the Integrations tab. 2. Find Higgsfield in the MCP directory and click Connect. 3. Visit the Higgsfield dashboard, generate an API key under your account settings, and copy it. 4. Paste the key into the Switchy connection dialog and click Authorize. 5. Switchy will verify the key and confirm the connection is live. 6. Open any Project and type '@Higgsfield generate an image of a mountain cabin at sunset' to test. 7. The MCP will return a request ID; wait a few seconds, then ask '@Higgsfield check the status of request [ID]' to retrieve the image URL. 8. If the request fails, check your Higgsfield account balance — most tools deduct credits per generation. 9. For character references, upload a public image URL first, then call Create Character Reference and note the Soul ID for future prompts.

What teammates see: by default, memories from Higgsfield are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Hero Image Concept

@Higgsfield generate a Soul V2 image: wide-angle view of a modern coworking space at golden hour, large windows, plants, warm lighting, photorealistic

Social Media Asset

@Higgsfield generate an image: close-up of a coffee cup on a wooden desk, laptop in soft focus background, morning light, 1:1 aspect ratio

Character Reference Setup

@Higgsfield create a character reference from this image: https://example.com/mascot.jpg and return the Soul ID when training completes

Text-to-Video Clip

@Higgsfield generate a Seedance 2 video: camera slowly pans across a forest trail at dawn, mist rising, cinematic color grading, 5 seconds

Cost Estimate Check

@Higgsfield estimate the cost for a Soul V2 Standard image at 1024x1024 resolution so I know how many credits this will use

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Higgsfield generate an image of a cyberpunk street market at sunset with neon signs reflecting in puddles, cinematic lighting

Output

Request submitted to Higgsfield Soul V2 Standard. Your generation ID is `req_8k3m9p2x`. The image is now queued and typically completes in 30–90 seconds depending on current platform load. Once processing finishes, the result will include a public URL to your rendered image. You can check status by asking me to poll this request ID, or wait for automatic completion notification if your workspace has webhooks configured.

Notes

This example shows the core text-to-image workflow. Higgsfield returns a request ID immediately, but the actual image renders asynchronously. Users need an API key with sufficient credits; the MCP does not auto-poll, so you must explicitly ask for status updates or integrate polling into your workflow.

Prompt

@Higgsfield create a character reference from this image URL https://example.com/portrait.jpg and name it 'Hero_A' for future consistent generation

Output

Character reference training started. Soul ID: `soul_7h4n2k9w` (status: training). Higgsfield is now processing your uploaded portrait to extract reusable style and identity features. Training typically takes 3–5 minutes. Once complete, you can reference this Soul ID in future image or video prompts to maintain character consistency across generations. Poll the Soul ID to confirm readiness before use.

Notes

Character references (Soul IDs) let you reuse a face or style across multiple prompts without re-uploading. This is Higgsfield's differentiator for narrative or branding work. Training requires a clear, well-lit source image and consumes credits; failed training (poor source quality) still deducts cost.

Prompt

@Higgsfield estimate the cost for generating a Soul V2 image at 1024x1024 resolution, then summarize whether my current credit balance covers ten such requests

Output

A single Soul V2 Standard image at 1024×1024 costs approximately 12 credits (~$0.12 USD at standard rates). Your account currently holds 95 credits, so ten requests would consume 120 credits — you're short by 25 credits. You can proceed with seven full-resolution generations now, or reduce resolution to 512×768 (6 credits each) to fit ten requests within budget. Higgsfield does not auto-reload credits; you'll need to top up manually if you want the full batch.

Notes

Cost estimation helps avoid mid-workflow failures when credits run out. This example pairs the MCP's read-only estimate tool with the AI's arithmetic to answer a planning question. Actual costs vary by model (Soul V2 vs. Seedance video) and resolution; always estimate before batch jobs.

Use-case deep-dives

Marketing campaign asset generation

When Higgsfield replaces your freelance designer queue

A 6-person marketing team running three concurrent campaigns needs 40+ social images per week. Higgsfield wins here because the Soul V2 and character-reference tools let you lock a brand character (train once with Create Character Reference, reuse the Soul ID across requests) and spin variants in minutes instead of days. The cost-estimate tool means your ops lead can budget credits before launch week. The trade-off: if your brand guidelines require pixel-perfect logo placement or legal review on every asset, the async generation flow (submit request, poll status, retrieve) adds friction that a design tool with live preview handles better. This MCP is the call when speed and volume matter more than frame-by-frame control.

Product concept visualization

Higgsfield for early-stage product teams exploring directions

A 3-person startup needs to show investors five different UI concepts for a consumer app before committing to design resources. Higgsfield's text-to-image and reference-image tools (Generate Image With References) let the founder describe each concept in a prompt, attach a mood board, and get mockups in under an hour. The 12-tool surface is overkill—most teams only touch Generate Soul V2 Image and Get Request—but the character-reference training is useful if you're iterating on a mascot or avatar across decks. The boundary: once you pick a direction and need production assets with exact dimensions or accessibility compliance, hand off to Figma. Use Higgsfield to decide, not to ship.

Video storyboard drafting

When Seedance 2 text-to-video beats static comps

A 4-person content team planning a 90-second explainer video needs to show stakeholders three narrative options before scripting. The Generate Seedance 2 Text Video tool turns a paragraph description into a rough motion sequence, which is faster than commissioning storyboard frames from an illustrator. The async pattern (submit, poll, retrieve) means you can queue all three concepts in one Switchy session and review results together in standup. The limit: Seedance output is a draft, not a final cut—if your stakeholders expect color-graded, on-brand footage, this MCP gets you to the decision point but not to publish. It's the right call when you need to kill bad ideas fast.

Frequently asked

What does the Higgsfield MCP do in Switchy?

It lets your team generate AI images and videos directly from chat by calling Higgsfield's Soul and Seedance models. You submit text prompts or reference images, get back a request ID, then poll for the finished media. All generation runs asynchronously, so you can queue multiple jobs without blocking the conversation.

Do I need a Higgsfield API key to connect this MCP?

Yes. The integration uses API key authentication, so you'll need an active Higgsfield account and a valid key with generation credits. Paste the key into Switchy's connection screen once; the MCP will authenticate every request automatically. Without credits on your Higgsfield account, generation calls will fail.

Can the MCP edit or upscale images I already have?

No. The twelve tools focus on starting new generation requests—text-to-image, text-to-video, and character reference training. If you want to modify existing assets, export the Higgsfield output and use a different MCP or upload it to an editing tool. This integration is strictly for creating net-new media from prompts.

Why use this MCP instead of the Higgsfield web dashboard?

The MCP keeps your creative workflow inside Switchy's shared chat, so the whole team sees prompts, request IDs, and results in one thread. You skip tab-switching and manual file downloads. The trade-off is less hand-holding—no visual preview picker, and you manage polling yourself by calling the status tool with the returned ID.

Who on the team should connect the Higgsfield account?

Whoever owns the Higgsfield subscription and API key. Generation costs draw from that account's credit balance, so connect it under the person or shared service account that controls billing. Everyone in the Switchy workspace can then trigger jobs through the MCP without needing their own Higgsfield login.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.