힉스필드, 터미널 생성 도구 사용 가이드 공개

힉스필드가 터미널에서 AI 이미지와 영상을 만드는 명령줄 도구 Higgsfield CLI의 사용 가이드를 공개했다. 웹 앱을 열지 않고 명령 한 줄로 생성 작업을 걸고, 같은 명령에서 낱말 하나만 바꿔 비용을 먼저 확인하는 방식이다. 힉스필드는 가이드에서 이 도구가 웹 앱과 같은 모델을 같은 계정, 같은 크레딧 잔액으로 돌린다고 밝혔다. 가이드에 실린 명령은 10월 16일 macOS에서 CLI 1.1.26 버전으로 검증했다고 회사 측은 적었다.

도구는 오픈소스로 깃허브에 공개돼 있고 MIT 라이선스를 달았다. 명령어 이름은 higgsfield이고 짧게 higgs로도 부른다. 설치 경로는 세 가지다. macOS와 리눅스는 curl 설치 스크립트나 홈브루로, 윈도를 포함한 모든 운영체제는 npm 패키지 @higgsfield/cli로 깐다. 업데이트는 처음 설치한 경로를 그대로 따라간다.

로그인에 API 키가 없다는 점이 이 도구의 성격을 정한다. 사용자는 브라우저 동의 화면에서 허용을 누르고, 터미널은 짧은 수명의 접근 토큰을 로컬 파일에 보관한다. 생성 비용은 계정의 요금제 크레딧에서 표준 요율로 빠진다. 힉스필드는 가이드에서 "웹 전용 혜택은 웹에 남는다"고 적었다. 웹 앱의 무제한 모델 이용과 무료 생성은 CLI 생성에 적용되지 않는다는 뜻이고, 그래서 CLI를 쓰려면 유료 구독이 필요하다.

힉스필드가 갖춘 프로그램 연결 통로는 세 갈래다. CLI는 터미널과 스크립트, 코딩 에이전트용이고 MCP는 클로드 같은 채팅 에이전트용이다. 둘은 같은 계정과 같은 크레딧을 나눠 쓴다. 반면 자체 애플리케이션용 Higgsfield API는 별도 API 키를 받고 미국 달러로 미리 충전한 잔액에서 차감하는 다른 상품이다. 메탈은 힉스필드의 클로드 광고 제작 워크플로를 보도한 바 있으며, 이번 CLI는 같은 계정을 채팅 밖 터미널로 넓히는 통로다.

생성 명령은 generate create 뒤에 모델 이름과 프롬프트를 붙인다. --wait 플래그는 작업이 끝날 때까지 기다렸다가 결과 링크를 찍고, --json 플래그는 스크립트가 읽을 수 있는 기록을 돌려준다. 가이드의 시험에서 이미지 한 장은 1분 안팎에 2752×1536 해상도로 나왔고 2크레딧이 들었다. 그 이미지를 시작 프레임으로 넣은 5초짜리 1080p 영상은 20분 대기 안에 끝났고 값은 80크레딧으로 매겨졌다. 같은 길이와 해상도의 초안 모드는 15크레딧이었다.

비용 확인은 generate cost 명령이 맡는다. 생성 명령과 같은 모델 이름과 파라미터를 받지만 작업을 만들지 않고 크레딧 값만 출력한다. 다만 음성 변환과 더빙 두 워크플로는 비용 추정을 지원하지 않는다. 기본 대기 시간은 10분이라 긴 영상은 명령이 시간 초과로 끝나도 서버에서는 작업이 계속 돈다. 가이드는 --wait-timeout 20m으로 대기 한도를 20분까지 올리라고 안내했다.

모델 목록은 웹 앱과 같은 카탈로그를 읽는다. 블로그는 35개 넘는 모델과 도구를, 깃허브 README는 이미지·영상·3D·오디오를 합쳐 40개 넘는 모델을 내세웠다. 10월 16일 시험에서 model list 명령은 107개 항목을 돌려줬다. 모드와 변형을 따로 세기 때문이라고 힉스필드는 설명했다. 영상 쪽에는 Seedance 2.5와 Kling v3.0, Google Veo 3.1, Wan 3.0이, 이미지 쪽에는 Nano Banana Pro와 GPT Image 2.5, FLUX.2가 이름을 올렸다. README는 Seedance 2.5를 "일반 영상 생성의 SOTA 기본값"이라고, GPT Image 2.5를 "이미지 생성과 디자인, 이미지 속 글자의 권장 기본값"이라고 적었다.

캐릭터 일관성 기능 Soul ID도 명령 세 줄로 다룬다. 캐릭터 하나에 사진을 최대 20장까지 넣어 학습시키고, 학습을 기다린 뒤, 나온 ID를 호환 이미지 모델에 넘긴다. 웹에서 만든 캐릭터와 CLI에서 만든 캐릭터는 같은 계정에 저장된다. 가이드는 본인이 소유했거나 사용 허락을 받은 사진만 쓰라고 적었다.

자동화의 핵심은 --wait를 빼는 데 있다. 그러면 생성 명령이 작업 ID만 즉시 돌려주고 끝나, 프롬프트 파일 한 줄마다 영상 작업 하나를 거는 반복문을 짤 수 있다. 결과는 저장해 둔 ID마다 generate wait로 모은다. 로컬 파일 경로를 이미지·영상·오디오 플래그에 넘기면 자동으로 올라간다.

코딩 에이전트도 같은 길을 쓴다. 가이드에 따르면 클로드 코드와 Codex, OpenClaw, Hermes는 CLI와 스킬 묶음으로 힉스필드에 붙고, 에이전트가 설치와 로그인 요청, 스킬 추가까지 직접 처리한다. 커서도 CLI와 스킬을 지원하고, 웹의 클로드는 MCP로, 챗GPT는 공식 힉스필드 플러그인으로 연결된다. README에는 생성 밖의 기능도 실렸다. React 19 기반 웹사이트를 만들어 배포하는 website 명령과 브라우저 게임을 올리는 game 명령, 10만 달러 규모 앱 콘테스트 참가 명령까지 들어 있다.

메탈이 확인한 가이드 전문과 README에는 설치 직후 버전이 어긋나는 사례도 그대로 적혀 있다. curl 설치 스크립트는 1.1.26을 보고했지만 version 명령은 예전 홈브루 설치가 남긴 1.0.1을 찍었고, brew upgrade로 해결됐다. 메탈은 앞서 힉스필드의 크리에이터 커뮤니티 공개도 전했다. 커뮤니티가 사람을 모으는 쪽이라면 CLI는 생성 작업을 사람 손에서 스크립트와 에이전트 쪽으로 옮기는 장치다. 무제한 혜택이 웹에만 남는 구조라, 손으로 몇 장 뽑는 사용자보다 수십 편을 한 번에 돌리는 개발자와 기술형 제작자에게 맞춘 도구라는 점이 분명하다.