higgsfield-ai/cli

Higgsfield CLI – ターミナルからAI生成

何であるか – シェルから直接40以上のHiggsfield AIモデル（画像、動画、3D、音声）を呼び出せるクロスプラットフォームのコマンドラインツール。認証、ジョブ送信、コスト見積もり、結果取得をすべて処理し、フルスタックのReactベースのウェブアプリを立ち上げたり、ブラウザゲームを公開したりすることも可能。すべてターミナルから完結。

インストール

• macOS/Linux：ワンライナー curl … | sh
• Homebrew tap（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スタイルのアセットに変換。
音声	テキストから音声（ElevenLabs、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ファイル（LICENSE）に従うオープンソース（MIT）。