Higgsfield CLI Brings AI Image and Video Generation to the Terminal

Higgsfield has published a guide to its open-source command-line client, Higgsfield CLI, which lets users generate images and videos from a terminal, script or coding agent without opening the web app. According to Higgsfield, it runs the same models as the web app from the same account and credit balance.
- Higgsfield CLI is an open-source client that generates images and videos from a terminal, script or coding agent.
- It signs in through the browser with no API key and charges plan credits at standard rates.
- Unlimited model access and free generations do not apply to CLI generations.
- Install options are curl, Homebrew or npm, and a paid Higgsfield subscription is required.
- The API is separate, with its own key and a prepaid US dollar balance.
What the CLI does and how it signs in
Higgsfield CLI is a command-line client for Higgsfield, which the company describes as an AI-native creative suite for video and image generation. The code and releases are on GitHub. The command is higgsfield, with higgs as a shorter alias.
Higgsfield says three things define how it works. There is no API key: users sign in through the browser with a regular Higgsfield account. Every generation is charged to that account's plan credits at standard rates. And web-only access stays on the web, so unlimited model access and free generations do not apply to CLI generations.
According to the guide, the CLI covers 35+ models and tools for image, video, 3D and audio, plus analysis such as Virality Predictor. It also handles training and reusing Soul characters, workflows such as reframe, dubbing, voice change and draw-to-video, and account tasks such as balance, transactions and billing workspaces. Marketing Studio assets, product photoshoots, website and game deployment are part of the same tool, though the guide focuses on image and video.
From install to a first video
The guide describes a path of six commands. Installation works through curl on macOS and Linux, through Homebrew, or through npm on any platform including Windows, where the package is @higgsfield/cli. A paid Higgsfield subscription is required. A coding agent is optional: Higgsfield says agents such as Claude Code, Codex, OpenClaw or Hermes can run the installation themselves.
After checking the version and signing in with higgsfield auth login, users generate an image with higgsfield generate create and a model id. The example uses nano_banana_2 for a 16:9 still. The image's job id is then passed as a start image to a video model, seedance_2_5, with a 5-second, 1080p setting.
Two flags matter from the start. --wait holds the terminal until the job finishes and prints the result link. --json returns machine-readable output. Without --wait, the create command returns a list of job ids, and generate wait <job_id> --json returns the record later. A separate generate cost command shows the price before a user commits credits.
For batches, the guide shows a shell loop that reads a prompt file and starts one job per line, saving the returned job ids to a text file.
CLI, MCP and API compared
Higgsfield offers three programmatic routes, and the guide says the choice comes before installation. The CLI is made for terminals, scripts and coding agents. MCP is aimed at chat agents such as Claude and other MCP-compatible clients. The Higgsfield API is for a user's own application.
- CLI and MCP both sign in through the browser without a key and bill plan credits at standard rates.
- The API uses a key from open.higgsfield.ai and a separate prepaid balance in US dollars, which does not use higgsfield.ai plan credits.
- None of the three includes unlimited model access.
CLI and MCP share one account and one credit balance, so switching between them changes the interface while the account, credits and Assets stay the same.
Sign-in details and a version pitfall
During login, the terminal prints "Opening browser for authentication" and waits. A consent page lists the access the CLI requests: email, basic profile, organization membership and permission to remember the login. The token is short-lived and stored in a local credentials file. Higgsfield advises treating it as a secret and not pasting it into prompts, logs, screenshots or source control. A "Session expired" message means running auth login again.
The guide also reports a troubleshooting case from its macOS test. The curl installer reported version 1.1.26, but higgsfield version printed an older 1.0.1 left from an earlier Homebrew install. Running which -a higgsfield showed both copies, and brew upgrade higgsfield fixed the mismatch.
What it means for users
For existing Higgsfield subscribers, the CLI offers a way to automate generation with the plan they already have, without a separate key or balance. Developers and teams that run scripts or coding agents can batch jobs and read results as JSON.
Higgsfield notes that its commands were checked on October 16, 2026 with Higgsfield CLI 1.1.26 on macOS, and that model ids, parameters and credit prices can change. It recommends model list, model get and generate cost for current values.
Higgsfield: How to Generate AI Video From Your Terminal With Higgsfield CLI


