Higgsfield
Higgsfield AI provides asynchronous image and video generation APIs powered by multiple creative AI models.
Verdict
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
- 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
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.
@Higgsfield generate an image of a cyberpunk street market at sunset with neon signs reflecting in puddles, cinematic lighting
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.
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.
@Higgsfield create a character reference from this image URL https://example.com/portrait.jpg and name it 'Hero_A' for future consistent generation
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.
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.
@Higgsfield estimate the cost for generating a Soul V2 image at 1024x1024 resolution, then summarize whether my current credit balance covers ten such requests
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.
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
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.
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.
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.