Skip to content

How to Generate AI Video From Your Terminal With Higgsfield CLI

2026-10-19 · blog how-to · Higgsfield · original

Topic: Higgsfield platform & ecosystem (also: Video generation & shot direction, Cost, credits & plans, Assets, references & consistency, Prompting & AI assistants, Image generation & editing) · mode: Tutorial · tags: prompts shared

This October 2026 Higgsfield blog guide covers Higgsfield CLI, which generates images and video from a terminal, a script or a coding agent on the same account and credits as the web app, with browser sign-in and no API key. It goes from installation to animating an image into a Seedance 2.5 video, then checking a job's price first, where a draft cost 15 credits against 80 for a full render. It ends with batch scripts, agents such as Claude Code, and the warning that Unlimited access does not apply in the CLI.

What is said

  • Frequently asked questions

What is said

★ — how much it matters to the source.

  • ★★★ Higgsfield CLI generates images and videos from a terminal, a script or a coding agent without the web app; it installs with curl, Homebrew or npm and runs the web app's models on the same account and credit balance. · Higgsfield CLI, image-to-video
  • ★★ Higgsfield CLI is an open-source command-line client whose code and releases are on GitHub; the command is higgsfield, with higgs as a shorter alias. · Higgsfield CLI
  • ★★★ Higgsfield CLI needs no API key: you sign in through the browser with a regular Higgsfield account. · Higgsfield CLI
  • ★★★ Every Higgsfield CLI generation is charged to the account's plan credits at standard rates. · Higgsfield CLI, credit
  • ★★★ Unlimited model access and free generations do not apply to Higgsfield CLI generations; they apply only on higgsfield.ai. · Higgsfield CLI
  • ★★ Higgsfield CLI covers 35+ models and tools for image, video, 3D and audio, plus analysis such as Virality Predictor. · Higgsfield CLI, image-to-video
  • ★★ Higgsfield CLI's workflow commands run Reframe, dubbing, voice change and Draw-to-Video. · Higgsfield CLI, Reframe
  • ★★ Beyond generation, Higgsfield CLI handles Marketing Studio assets, product photoshoots, and website and game deployment. · Higgsfield CLI, Marketing Studio
  • ★★ Higgsfield's quick start for the CLI takes six commands: install, check the version, sign in through the browser, generate one Nano Banana 2 image, check the price and animate it with Seedance 2.5, then start a batch. · Higgsfield CLI, Nano Banana 2, Seedance 2.5
  • ★★★ Higgsfield CLI and Higgsfield MCP share one account, credit balance and Assets library; the Higgsfield API is a separate product with its own API key and a prepaid US-dollar balance that does not use higgsfield.ai plan credits. · Higgsfield CLI, Higgsfield MCP, Higgsfield API, Claude
  • ★★ Higgsfield CLI needs a paid Higgsfield subscription, a terminal on macOS, Linux or Windows, and curl, Homebrew or npm (which needs Node.js). · Higgsfield CLI
  • ★★ Higgsfield advises installing the CLI with the method (curl, Homebrew or npm) that matches the rest of your setup, because updates go through the method you installed with. · Higgsfield CLI
  • ★★ Higgsfield CLI's npm package, @higgsfield/cli, installs on any platform including Windows; curl covers macOS and Linux. · Higgsfield CLI
  • ★ If higgsfield version disagrees with the installer, Higgsfield advises checking for a second copy first; in its test an old 1.0.1 Homebrew copy shadowed 1.1.26 until brew upgrade fixed it. · Higgsfield CLI
  • ★★ Higgsfield CLI sign-in: higgsfield auth login opens a Higgsfield consent page listing email, basic profile, organization membership and remembering the login; after Allow, higgsfield account status prints email, plan and credits. · Higgsfield CLI
  • ★★ Higgsfield advises treating the CLI access token printed by higgsfield auth token as a secret, never pasted into prompts, logs, screenshots or source control; a "Session expired" message means signing in again. · Higgsfield CLI
  • ★ In Higgsfield CLI, workspace list shows the account's billing workspaces with plan and balance, and workspace select picks the one generations are charged to. · Higgsfield CLI
  • ★★ In Higgsfield CLI, generate create takes a model id and --prompt; --wait holds the terminal until the job finishes and prints the result link, and --json returns machine-readable output. · Higgsfield CLI
  • ★★ Higgsfield calls generating an image first and then animating that same image the usual order when a clip has to match an approved frame. · Higgsfield CLI, image-to-video, keyframe
  • ★★ Higgsfield CLI's --start-image flag accepts a job id from a previous generation, an upload id or a local file path, and local files are uploaded automatically. · Higgsfield CLI
  • ★★★ Seedance 2.5 in Higgsfield CLI needs --mode omni reference for a start image or reference images, because its default text-only mode does not accept media. · Seedance 2.5, Higgsfield CLI
  • ★ Files generated through Higgsfield CLI appear in Assets on higgsfield.ai alongside web generations. · Higgsfield CLI
  • ★★ In Higgsfield's CLI test, a Nano Banana 2 image finished in about a minute at 2752 by 1536 for 2 credits, and a 5-second 1080p Seedance 2.5 video from it was priced at 80 credits. · Nano Banana 2, Seedance 2.5, Higgsfield CLI
  • ★★ Higgsfield CLI's --wait waits 10 minutes by default and 1080p video can take longer; the job keeps running on the server and generate get shows its status. · Higgsfield CLI
  • ★★ For long video jobs Higgsfield advises adding --wait-timeout 20m in the CLI, which raises the waiting limit to 20 minutes. · Higgsfield CLI
  • ★ The params block of a Higgsfield CLI job shows unset defaults; for the Seedance 2.5 video they were 16:9, standard bitrate and audio generation on. · Seedance 2.5, Higgsfield CLI
  • ★★★ Higgsfield advises checking a job's credit price with higgsfield generate cost, which takes the same model id and parameters as generate create but creates no job. · Higgsfield CLI, credit
  • ★★★ In Higgsfield's test, a 5-second 1080p Seedance 2.5 clip was priced at 80 credits for a full render and 15 credits as a draft, which makes draft a cheaper preview before the final pass. · Seedance 2.5, Higgsfield CLI
  • ★ The voice-change and dubbing workflows of Higgsfield CLI do not support cost estimation. · Higgsfield CLI
  • ★★ Higgsfield CLI reads the same model catalog as the web app: model list prints every job type, and model get prints one model's parameters, defaults and limits. · Higgsfield CLI
  • ★★ On 16 October 2026 Higgsfield CLI's model list returned 107 entries, since each mode and variant (upscalers, background removers, Nano Banana Pro modes) is listed separately. · Higgsfield CLI, Nano Banana Pro
  • ★★ Models callable from Higgsfield CLI as of 16 October 2026 include Seedance 2.5, Kling 3.0, Wan 3.0, Nano Banana 2, GPT Image 2.5, FLUX.2, Soul 2.0 and Virality Predictor. · Seedance 2.5, Kling 3.0, Wan 3.0, Nano Banana 2, GPT Image 2.5, Flux.2, Soul 2.0, Higgsfield CLI
  • ★★ Higgsfield CLI's model get shows Seedance 2.5 with four modes (text to video, omni reference, video edit, video extension), defaults of 5 seconds at 720p with audio on, up to 50 reference items and a cheaper draft option. · Seedance 2.5, Higgsfield CLI
  • ★★ Training a Soul ID in Higgsfield CLI takes up to 20 photos per character, the CLI's limit, given as local paths or upload ids; --soul-cinematic trains the Soul Cinematic variant. · Soul ID, Soul 2.0, Soul Cinema, Higgsfield CLI
  • ★★ Soul ID characters trained on the web and in Higgsfield CLI are stored in the same account, so a browser-made Soul ID can be called from a script. · Soul ID, Higgsfield CLI
  • ★★ Higgsfield says Soul ID helps keep a character's identity consistent across generations, though results still vary from shot to shot. · Soul ID
  • ★ Higgsfield advises training Soul ID only on photos you own or have permission to use. · Soul ID
  • ★★ Higgsfield CLI's --json works on every command and returns raw records, and local files passed to --image, --video or --audio are uploaded automatically. · Higgsfield CLI, image-to-video
  • ★★★ For a batch, Higgsfield advises running generate create without --wait in a loop over a prompt file, saving each returned job id, then a second loop that runs generate wait on every saved id. · Higgsfield CLI, Seedance 2.5, batch generation
  • ★ Higgsfield says listing completed results with generate list covers the whole generation history, useful for a quick look but not for collecting one batch. · Higgsfield CLI
  • ★★★ Claude Code, Codex, OpenClaw and Hermes connect to Higgsfield through CLI + Skills; the agent can install the package, run auth login for browser approval, and add the skills with npx skills add higgsfield-ai/skills. · Claude Code, Codex, OpenClaw, Hermes Agent, Higgsfield CLI
  • ★★ Higgsfield's Skills are preset workflows for tasks such as ads, UGC videos and faceless content.
  • ★★ Cursor supports CLI + Skills alongside its marketplace integration; Claude on the web connects to Higgsfield through MCP, and ChatGPT through the official Higgsfield Plugin. · Cursor, Higgsfield CLI, Claude, Higgsfield MCP, ChatGPT, Higgsfield ChatGPT Plugin
  • ★★ Higgsfield says the CLI fits people who already work in a terminal: developers wiring generation into a build step, creators batching dozens of clips from a prompt file, and users of Claude Code, OpenClaw or Hermes. · Higgsfield CLI, Claude Code, OpenClaw, Hermes Agent
  • ★★★ For a mostly manual workflow on models in your Unlimited web access, Higgsfield says generating on higgsfield.ai may use fewer credits than the CLI, where Unlimited does not apply. (hedged) · Higgsfield CLI, credit
  • ★ Higgsfield checked the guide's commands on 16 October 2026 with Higgsfield CLI 1.1.26 on macOS, and says model ids, parameters and credit prices can change. · Higgsfield CLI

Threads in this video

Mentioned

Central: Higgsfield CLI · Seedance 2.5

Also: Concepts: batch generation · credit · image-to-video · keyframe · Skill

Products: ChatGPT · Claude · Claude Code · Codex · Cursor · Flux.2 · GPT Image 2.5 · Hermes Agent · Higgsfield API · Higgsfield ChatGPT Plugin · Higgsfield MCP · Higgsfield Video Explainer · Kling 3.0 · Marketing Studio · Nano Banana 2 · Nano Banana Pro · OpenClaw · Reframe · Sketch-to-Video · Soul 2.0 · Soul Cinema · Soul ID · Veo 3.1 · Virality Predictor · Wan 3.0

← Previous: 9 Best AI Lip Sync Video Generators in 2026 · Next → 5 Best AI Side Hustles in 2026 (ft. Iman Gadzhi)