Artificial intelligence news.
Straight from the original announcements.

Higgsfield CLI Brings AI Image and Video Generation to the Terminal

October 19, 2026, 11:07By the AI News Bites Editorial TeamSource: Higgsfield
Higgsfield CLI Brings AI Image and Video Generation to the Terminal
Image: Higgsfield

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.

Key points
  • 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.

Related news

Higgsfield Takes Top Spot in Ramp’s Image and Video AI Rankings
BusinessNovember 14, 2026, 22:05

Higgsfield Takes Top Spot in Ramp’s Image and Video AI Rankings

Higgsfield ranks as the most adopted Image and Video AI platform in Ramp Rate’s November 2026 rankings, with 42% of businesses buying this type of software through Ramp…

Higgsfield offers up to 60 days of unlimited AI generation
Products and toolsNovember 11, 2026, 15:31

Higgsfield offers up to 60 days of unlimited AI generation

Higgsfield's 11.11 promotion offers up to 60% off annual plans, up to 60 days of Unlimited generation on selected models, and a three-day Higgsfield MCP free trial. The…

Higgsfield Launches 7-Day Unlimited Bonus for Image and Video Models
Products and toolsOctober 30, 2026, 19:04

Higgsfield Launches 7-Day Unlimited Bonus for Image and Video Models

Higgsfield has launched a 7-Day Unlimited Bonus that gives eligible subscribers unlimited generation on a selection of image and video models. The offer covers Seedream…