What you’ll have at the end
One studio for AI images and videos: a single prompt bar, 38 models (8 image and 30 video, including Kling, Seedance, Wan, Flux, Ideogram, Recraft, LTX, MiniMax and more), the right settings for each model, and a gallery of everything you’ve made.
- You still pay for generations. The studio is free, but every image or video runs on Higgsfield’s own API using your Higgsfield API key, and Higgsfield bills you per generation from a prepaid balance. It’s pay-as-you-go instead of a monthly subscription, not free generation.
- No licence file. The README calls it “free and open-source”, but on 17 Nov 2026 the repo had no LICENSE file, so its open-source licence isn’t clear. Fine to try. Check again before you modify it or build a business on it.
- Several repos share this name. This guide covers
wide-trace/open-higgsfield, the most-starred one.
Written from the project’s GitHub README, read on 17 Nov 2026.
First: get your Higgsfield API key
OpenHiggsfield doesn’t give you a key. You get it from Higgsfield’s developer console, then paste it into the studio. Both options below need this.
Sign up on the Higgsfield Console
Go to console.higgsfield.ai and create an account. This is Higgsfield’s developer console, separate from the normal higgsfield.ai app subscription.
Add a small balance
The API is pay-as-you-go: you top up a balance, and each image or video is deducted from it. Start with the smallest top-up you can, and check the per-model price before you generate. Videos cost much more than images.
Create an API key
In the console, open the API keys section and create a new key. You get two values: a Key ID and a Secret. Copy both somewhere safe straight away, because you may not be shown the secret again.
Join them with a colon
The studio wants one line in the format
KEY_ID:SECRET. Put the Key ID first, then a colon:, then the Secret, with no spaces.your-key-id:your-secret
Anyone with this key can spend your Higgsfield balance. Never post it in a screenshot, comment or WhatsApp. Make a separate key just for OpenHiggsfield, keep only a small balance on the account, and delete the key in the console if you stop using the studio or think it leaked. On the hosted site (Option A), the key sits on a server run by the OpenHiggsfield project, not by Higgsfield. If that worries you, use Option B.
Key format, console and pay-as-you-go billing are from Higgsfield’s official API docs (docs.higgsfield.ai, read 18 Nov 2026). Menu names inside the console can change.
Option A: in the browser (5 minutes)
Open the hosted studio
Go to openhiggsfield.ai. There’s nothing to install.
Paste your key
Click the key icon (Add platform key) in the top bar and paste your
KEY_ID:SECRETline from above. Press Save key. The key is stored in a secure cookie on the server. If it’s missing, the studio asks for it instead of failing quietly.
Option B: run it yourself
You need Node.js, pnpm and a Vercel Blob token for file uploads. If those words are new, use Option A.
Download and install
cd open-higgsfieldpnpm installSet two environment values
Copy
.env.exampleto.env.localand fill in:HF_API_BASE_URL: the address of the generation API. Higgsfield’s docs usehttps://api.higgsfield.aiOPEN_HIGGSFIELD_READ_WRITE_TOKEN: your Vercel Blob read-write token, used for uploads
Start the studio
Open http://localhost:3000, click the key icon, and paste yourpnpm devKEY_ID:SECRETline.
How to use it
- Pick a model. The model you pick decides whether you get an image or a video.
- Write your prompt. Add a start frame, end frame or reference images if the model supports them.
- Press Ctrl/⌘ + Enter. You can make up to 4 results at once.
- Use Reuse on any finished result to restore its model, settings and prompt, so you can make a variation.
Product shot of a Kerala banana chips packet on a banana leaf, soft morning light, 9:16, close-up, steam rising from a cup of chai in the background.
Good to know
- Your history (the last 60 items) is saved in your browser. Favourites are always kept.
- Result links belong to the generation platform and can expire, so download anything you want to keep.
- Failed, NSFW-blocked and cancelled runs show up as failed tiles with a retry button.
Back to the full list: 4 open-source alternatives to paid AI tools