higgsfield-ai/cli

Higgsfield CLI – 터미널에서 AI 생성

무엇인가요 – 쉘에서 직접 40개 이상의 Higgsfield AI 모델(이미지, 동영상, 3D, 오디오)을 호출할 수 있는 크로스플랫폼 명령줄 도구입니다. 인증, 작업 제출, 비용 예측, 결과 수신을 모두 처리하며, 풀스택 React 기반 웹 앱을 생성하거나 브라우저 게임을 배포할 수 있습니다. 모든 작업을 터미널에서 완료할 수 있습니다.

설치 방법

• macOS/Linux: 단일 명령어 curl … | sh
• Homebrew 탭 (brew install higgsfield-ai/tap/higgsfield)
• 모든 플랫폼: npm (npm install -g @higgsfield/cli)
• 사전 빌드된 바이너리 수동 다운로드

일반적인 워크플로우

1. higgsfield auth login – API 토큰 저장
2. 작업 생성 예: higgsfield generate create nano_banana_2 --prompt "a quiet beach at sunrise" --wait
3. CLI가 서비스를 폴링하여 자산이 준비되면 URL(또는 --json로 JSON)을 출력

주요 기능

영역	CLI에서 수행 가능한 작업
이미지	Nano Banana Pro, FLUX.2, GPT-Image 2.5, Soul V2 등으로 이미지 생성, 확대, 외부 채우기, 배경 제거, 스타일 전이
동영상	텍스트에서 동영상 생성, 스타일 가이드 클립, 재프레임, 음성 변경, 더빙, 바이러럴리티 분석(Virality Predictor) – Seedance 2.5, Kling v3.0, Gemini Omni 모델 사용
3D 자산	다중 이미지 세트 또는 텍스트 프롬프트를 3D 메시, 리깅, Tripo 스타일 자산으로 변환
오디오	텍스트에서 음성(ElvenLabs, Minimax 등), 음악 생성, 음성 교체
워크플로우	다중 모델 호출을 묶은 고수준 파이프라인(그림 → 동영상, 재프레임, 음성 변경, 더빙)
웹사이트	React 19 + TanStack Start 앱 스크래핑, 일시적 git 토큰을 통한 코드 푸시, Cloudflare Worker 기반 사이트로 배포. 템플릿(app-detail, preset, studio) 또는 일반 웹사이트 선택 가능
게임	브라우저 게임을 포함한 ZIP 파일 업로드 후 Higgsfield 마켓플레이스에 게시
Soul ID	몇 장의 사진으로 개인용 "Soul" 캐릭터를 훈련하고, 얼굴 충실도 높은 이미지 생성에 재사용
비용 예측	higgsfield generate cost …로 특정 모델 또는 워크플로우에 필요한 크레딧 예측
계정 및 워크스페이스	크레딧 잔액, 거래 내역 확인, 청구 워크스페이스 전환

모델 카탈로그 – higgsfield model list 명령어로 40개 이상의 모델을 확인할 수 있습니다. 이미지(23), 동영상(22), 3D(5), 오디오(5)로 분류됩니다. 각 모델은 고유의 job_set_type (예: nano_banana_2, seedance_2_5, text2speech_v2)와 MODELS.md에 문서화된 파라미터 세트를 가집니다.

예시 명령어

# 간단한 이미지 생성
higgsfield generate create gpt_image_2_5 \
  --prompt "clean infographic showing global energy mix" \
  --aspect_ratio 3:4 --quality high --resolution 2k --wait

# 오디오 더빙 포함 동영상
higgsfield generate workflow dubbing \
  --video ./ad.mp4 --target_language spa --wait

# 풀스택 앱 배포
higgsfield website create \
  --type app --category ads-marketing --template studio --subdomain my-ads
# 복제, 편집, 푸시 후 배포
higgsfield website repo-access <id>
# …git work…
higgsfield website deploy <id>

왜 중요한가 – 가벼운 CLI를 통해 풍부한 생성형 AI 서비스를 노출함으로써, 콘텐츠 파이프라인을 스크립트화하거나 CI/CD에 AI 자산을 통합하거나, HTTP 클라이언트 코드를 전혀 작성하지 않고도 제품 프로토타이핑이 가능해집니다. 또한 웹앱 스크래핑 및 마켓플레이스 게임 게시를 위한 엔드투엔드 툴을 통합하여, 단일 바이너리로 완전한 크리에이티브 생산 워크스테이션을 구현합니다.

라이선스 – 라이선스 파일(LICENSE)에 따라 오픈소스입니다.