# Higgsfield execution reference

Official install: https://github.com/higgsfield-ai/cli — Windows supports `npm install -g @higgsfield/cli` with Node.js/npm installed. Sign in with `higgsfield auth login`. Do not export Akash's credentials. The builder uses authorized account access on their own machine. Browser generation is a fallback when CLI cannot run; it still requires a human or browser tool to upload and generate.

Read-only discovery:
```
higgsfield account status
higgsfield model list --json
higgsfield model get hf_mult_replace_object --json
higgsfield model get hf_mult_motion_control --json
higgsfield model get seedance_2_0 --json
higgsfield generate create --help
higgsfield generate cost --help
```

September 9 read-back: Genjutsu Object Swap = `hf_mult_replace_object`; Motion Transfer = `hf_mult_motion_control`. Both accept `image_references`, `video_references`, optional `prompt`, `resolution` 480p/720p/1080p (720p default), requiring exactly one video and >=1 image. Official CLI media aliases `--image` and `--video` accept local files; validate current model support before submission. Image-to-video can use `seedance_2_0 --start-image FILE`. Do not send a video to an image-only flag.

Paid command shapes, only after the selected job's allowance:
```
higgsfield generate create hf_mult_replace_object --video "inputs/source.mp4" --image "inputs/replacement.png" --prompt "Change only the named detail; preserve repair mechanics and camera timing" --resolution 720p --wait --json
higgsfield generate create hf_mult_motion_control --video "inputs/source.mp4" --image "inputs/new-scene.png" --prompt "Preserve this simple source motion in the checked new scene" --resolution 720p --wait --json
higgsfield generate create seedance_2_0 --start-image "inputs/approved-start.png" --prompt "One restrained camera move; all installed hardware stays fixed" --duration 5 --aspect_ratio 9:16 --wait --json
```

These are command templates, not an execution receipt or guaranteed valid settings forever. Query `generate cost` with the same media/settings where supported; otherwise use the generator's displayed quote. Uploads may themselves transmit source material even when a cost preview is free. Only use cleared references. Save returned job IDs, retrieve/wait an existing job if interrupted, and download the returned video URL with an authorized download tool. Do not assume JSON is a single object; inspect current shape.

The product guide https://higgsfield.ai/blog/higgsfield-genjutsu says 4–30 seconds and up to 30 images; https://higgsfield.ai/genjutsu says 3–30 and up to 40. Use the overlapping 4–30 / <=30 range unless current validation says otherwise. One image is enough for the initial trial. No underlying model identity is assumed.

Virality Predictor is optional paid attention scoring. It does not replace watching frames, checking the trade or verifying real ad results. No Arcads product ID, Supadata token, private brain database or third-party transcription account is required for silent local B-roll analysis.