Resources / Video editing / OpenHiggsfield setup guide (Higgsfield alternative)
OH

OpenHiggsfield setup guide (Higgsfield alternative)

Use OpenHiggsfield's free AI image and video studio in the browser or self-host it. What you pay, where your key goes, and the licence warning.

Sources checked 17 Nov 2026Browser, Node.js, VercelVideo editingIntermediate

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.

Read before you use it for business
  1. 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.
  2. 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.
  3. Several repos share this name. This guide covers wide-trace/open-higgsfield, the most-starred one.
How this guide was made

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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

Treat this key like your card

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.

Source

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)

  1. Open the hosted studio

    Go to openhiggsfield.ai. There’s nothing to install.

  2. Paste your key

    Click the key icon (Add platform key) in the top bar and paste your KEY_ID:SECRET line 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

For developers

You need Node.js, pnpm and a Vercel Blob token for file uploads. If those words are new, use Option A.

  1. Download and install

    cd open-higgsfield
    pnpm install
  2. Set two environment values

    Copy .env.example to .env.local and fill in:

    • HF_API_BASE_URL: the address of the generation API. Higgsfield’s docs use https://api.higgsfield.ai
    • OPEN_HIGGSFIELD_READ_WRITE_TOKEN: your Vercel Blob read-write token, used for uploads
  3. Start the studio

    pnpm dev
    Open http://localhost:3000, click the key icon, and paste your KEY_ID:SECRET line.

How to use it

  1. Pick a model. The model you pick decides whether you get an image or a video.
  2. Write your prompt. Add a start frame, end frame or reference images if the model supports them.
  3. Press Ctrl/⌘ + Enter. You can make up to 4 results at once.
  4. 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.
Get OpenHiggsfield

Back to the full list: 4 open-source alternatives to paid AI tools