3行でいうと

  • コーディング用エージェントには、CLI(higgsfield)とスキルが公式の道です。スキルの入れ方は、READMEが4通りを挙げ、npx skills を「recommended」と書いています。
  • 制作ソフトのプラグインは、ソフトごとに入れ方と版の条件が違い、Adobe系は公式ページ同士で書き方が食い違っています。
  • BlenderとAfter EffectsのBridgeは、エージェントを開いているソフトにつなぐ別のコネクタで、URLは bridge.higgsfield.ai/mcp(通常のMCPとは別)です。
  • APIは別の製品で、前払いの米ドルの残高、Authorization: Key <ID>:<SECRET> の認証、非同期の提出と確認で動きます。コンソールのURLが公式ページ同士で食い違っています。
  • どの接続でも、ウェブ版の無制限と無料の生成は使えず、クレジット(APIは残高)が減ります。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はHiggsfieldを入れていますが、使い心地はこの記事には書いていません。手順は、公式の手順を順に並べたものです。コマンドやURLは公式の表記を写していますが、取得したのはページの要約なので、システムにコマンドやインストーラ、署名のないファイルを入れる操作は、実行の前に公式の原文で確かめてください。読み切れていない所は「確認できていない」と書き、長い引用は避けて言い換えています。「この記事の案」「僕らの見立て」と書いた箇所は、公式の記載とは別の、この記事で組んだ例です。

先に結論

前提:用語をそろえる

A. Claude Code・OpenClaw・Hermes・Codexなど(CLI+スキル)

公式のヘルプ(「How do I access Higgsfield via CLI?」)は、CLIとスキルはコーディング用のエージェント向け(Claude Code、Cursor、Codex)、MCPはチャット系向け(Claudeのウェブ、Cowork)、と整理しています。CLIとスキルは、固定された手順でトークンの量が少なく、出力が揃う、とも書かれています(要約)。どちらも同じアカウントとレートで、APIキーは要らず、無制限のモデルは使えません。両方を入れる必要はありません。

A-1. エージェントに頼んで入れさせる(連携の記事)

Claude Code、OpenClaw、Hermesでは、エージェントに「Higgsfieldをセットアップして」と頼む形です。エージェントが、次を行う、と書かれています。

  1. CLIを入れる:npm i -g @higgsfield/cli
  2. 認証する:higgsfield auth login(ブラウザが開くので、サインインを済ませる)
  3. 付属のスキルを入れる:npx skills add higgsfield-ai/skills

CLIのページ(higgsfield.ai/cli)には、Claude Codeに貼るメッセージ(この3手順を含む)が載っている、と要約されました。全文はページで確認してください。

エージェント向けの案内(リポジトリの INSTALL_FOR_AGENTS.md)の要約では、エージェントがCLIの導入(インストールスクリプトを実行)、higgsfield version での確認、スキルの置き場への git clone、試し生成、報告を行い、人は、必要なら sudo のパスワードを入れ、ブラウザでOAuthの許可を済ませる、という分担でした。スキルの置き場は、Claude Codeが ~/.claude/skills/higgsfield、Cursorが ~/.cursor/plugins/higgsfield、Codexが ~/.codex/plugins/higgsfield、そのほかが ~/.<agent>/skills/higgsfield、と要約にありました。試し生成は本物の生成で、クレジットが減ります。

僕らの見立て:これらは、インストールスクリプトの実行と git clone を、エージェントに任せる形です。任せる前に、コマンドの中身を公式の原文で確かめるのがよいと思います。

A-2. 自分で入れる(スキルの4通り)

リポジトリ higgsfield-ai/skills(MITライセンス)のREADMEが挙げる4通りです。READMEは、どの方法も、CLIの導入と認証を、スキルのセットアップの一部として扱う、と書いています。INSTALL.mdは、前提としてCLIを入れてログインしておく形で、higgsfield-websites には git と bun も要る、と書いています。

方法 コマンドの要点 備考(公式の記載)
npx skills npx skills add higgsfield-ai/skills READMEが「recommended, cross-agent」と書く。Claude Code、Cursor、Codex、~/.<agent>/skills/<name>/SKILL.md を読むエージェント。Node.jsが要る
gh skill install gh skill install higgsfield-ai/skills GitHub CLI v2.90以降
Claude Codeのマーケットプレイス Claude Codeの中で /plugin marketplace add higgsfield-ai/skills、続けて /plugin install higgsfield@higgsfield Claude Codeだけ
セットアップスクリプト git clone --depth 1 https://github.com/higgsfield-ai/skills.git、cd skills、./setup 予備の方法。--host <agent> で上書き。何度実行してもよい、とINSTALL.mdにある

A-3. 使ってみる

  1. エージェントに「Higgsfieldで画像を作って」と頼むか、/higgsfield:generate(READMEの表は /higgsfield:higgsfield-generate)を実行します。
  2. この記事の例(動作は確かめていません):「Higgsfieldのgenerateスキルで、静かな海辺の朝の画像を作って。生成の前に費用を見せて、私が承認してから生成して。」(READMEの generate cost の例はワークフロー向けで、ふつうのモデルで使えるかは、公式で確認できていません)
  3. 生成は非同期で、エージェントが結果を確認しにいきます。完成したものは Assets に入ります。

A-4. スキルの数と名前、Supercomputerとの違い

A-5. 外し方とつまずき

B. 制作ソフトの公式プラグイン

公式の「What external integrations does Higgsfield support?」(ヘルプ、2026年8月1日付と表示)と、各プラグインのページの記載です。どれも、ウェブ版と同じレートでクレジットを使い、無制限と無料の生成は使えない、と書かれています。既定のモデルは、画像がNano Banana 2、動画がSeedance 2.0、とヘルプにあります。

ソフト 入れ方(公式の記載) 条件
Figma、FigJam Plugins → Find more plugins で「Higgsfield AI」(Higgsfield Inc)を探す。またはFigma Communityのページ 記載なし
Photoshop higgsfield.ai/plugins/photoshop からインストーラ。Window → Extensions → Higgsfield 2024以降、macOSかWindows、インターネット
Premiere Pro、After Effects ヘルプとページで記載が違う(B-2) 版の条件も違う
DaVinci Resolve higgsfield.ai からダウンロードして、プラグインのフォルダに置く 記載なし。フォルダの場所も未確認
Blender higgsfield.ai/plugins/blender の署名つき.zip(zipのまま)。窓に落とす、または Edit → Preferences → Add-ons → Install 5.1以降。WindowsかmacOS(OSはヘルプの記載で、Blenderのページ自体には書かれていません)
Minecraft .jarを mods/ に入れ、ゲーム内で /higgsfield auth、ブラウザで許可 1.21.1とNeoForge

B-1. Photoshop

  1. higgsfield.ai/plugins/photoshop から、macOSかWindows用のインストーラ(ヘルプは「.UXP」)をダウンロードして入れます。補助のアプリは要りません。
  2. Photoshopを開き、Window → Extensions → Higgsfield を開きます。

ページには書き方が2通りあります。1つは、1つの「.ccx」がApple SiliconとIntelの両方で使え、aescriptsのZXP Installerに落とす説明。もう1つ(FAQ)は、「.uxp」のインストーラをApplicationsに入れて起動し、Photoshopを自動で見つける説明です。どちらが現行か、確認できていません。出ないときは、2024以降かを確かめ、再起動し、入れ直すか問い合わせる、と書かれています。生成物は新しい編集できるレイヤーで返ります。ファイルはHiggsfieldのサーバーで処理され、FAQによると学習には使われない、とあります(ウェブ版の規約との関係は確認できていません。01、04)。

B-2. Premiere ProとAfter Effects

項目 ヘルプ(外部連携の記事) After Effectsのプラグインのページ
macOS .dmgを開き、Applicationsにドラッグしてインストーラを起動。両方のアプリを自動で見つける 同じ形(Higgsfield.appをApplicationsへ)
Windows aescripts.comの無料のZXP Installerに、Higgsfieldの.zxpを落とす .msiのインストーラを実行
版の条件 2024(24.0)以降 2025(25.0)以降。Windows 10か11の64ビットのみ

パネルは Window → Extensions → Higgsfield です。入れる前に、Adobeのアプリを完全に終了します。出ないとき:アプリを完全に終了してインストーラをやり直す(ヘルプ)。Windowsは管理者として実行、macOSは System Settings → Privacy & Security の「Open Anyway」、Window → Extensions に隠れていないか(ページ)。2つの食い違いは、どちらが最新か確認できていないので、入れる前に公式のダウンロードの案内を見てください。

B-3. DaVinci Resolve、Figma、Minecraft、Blender

C. 制作ソフトの中で、AIエージェントを動かす接続

C-1. Bridge(BlenderとAfter Effects)

ヘルプは、Blenderの記事で、通常のMCP(生成した素材を渡す)と、Bridge(エージェントを、開いているBlenderのアドオンに直接つなぎ、シーンの中で作業させる)を、別のものとして書いています。

手順(ヘルプとBlenderのページの記載):

  1. 先に、上のB-3でアドオンを入れて、サインインしておきます。
  2. エージェント(ClaudeやChatGPTなど)の設定で、Settings → Connectors を開き、custom connectorを足します(ヘルプは、AI agent connectionの記事を案内)。
  3. 名前を Higgsfield Bridge、URLを https://bridge.higgsfield.ai/mcp にします。
  4. 求められたら、サインインします。
  5. 作りたいシーンを頼みます(Blenderのページの例は、calibration bay のブロックアウトを頼む文)。

  6. ページによると、エージェントは、ブロックアウトを作る、3Dカーソルの位置にメッシュを置く、Seedanceのレンダーを始める、といったことができる、とあります。

  7. After Effectsのページ(higgsfield.ai/plugins/after-effects)にも、「MCP Bridge」が書かれ、アドレスは bridge.higgsfield.ai/mcp、手順は、Settings → Connectors → custom connector(名前 Higgsfield Bridge)、と同じ形です。ページの例は、バウンスのイージングと光の筋のロゴの登場です。ChatGPTには、別のプラグインのURLで同じ流れ、とあります。
  8. 権限の範囲、何がHiggsfieldに渡るか(開いているシーンの内容など)は、読んだ範囲では書かれていません(確認できていない)。ソフトのファイルが、エージェントを通じて外に出る形なので、その扱いを、使う前に確かめてください(これは僕らの見立てです)。
  9. Bridgeの取り消し(ログアウトや接続の解除)の記載は、読んだページに見つかりませんでした。エージェント側のコネクタのDisconnect(07)が、画面としては見えるものです。

C-2. Production Skills Bundle(制作ソフトの11のワークフロー)

公式のページ(higgsfield.ai/mcp/bundles/production-skills)の11個です。Blender:/Destruction-Studio、/Exploded-view、/Scene-Builder、/Cartoon-shaders。Premiere Pro:/Project-sorter。After Effects:/Shot-Composer、/Shot-Cleanup。Illustrator:/Vectorize。Photoshop:/Image-fixer。TouchDesigner:/use-touchdesigner。DaVinci Resolve Studio:/color-grading。

C-3. Katana(映像の様式の作り直し)

公式のページ(higgsfield.ai/mcp/katana):Higgsfieldのツールをアシスタントにつなぎ、依頼を /katana で始めます。手順は、参照動画かKatanaのプリセットから始める → 自分の素材をアップロード → 変えたいところと残したいところを書く → 結果を見る → 指示を直して次の版を作る。After EffectsとBlenderは要りません。費用の数字は、ページにありません。

D. Supercomputerのコネクタ

公式のヘルプ(How do I use Supercomputer?)は、Supercomputerの左のサイドバーに Connectors があり、メッセージ、SNSへの公開、メールとカレンダー、ドキュメントの区分で、Telegram、Slack、TikTok、Gmail、Google Drive、Notionなどがつなげる、と書いています。全部の一覧は、画面の中の Connectors の節にある、とされています。

E. API(自分のプログラムから呼ぶ)

AIアプリとの連携とは別の製品で、ウェブ版のプランとは別の残高を使います。公式のヘルプ(What is the Higgsfield API, and how do I get started?)とドキュメント(docs.higgsfield.ai)の記載です。

手順:始める(ヘルプの記載)

  1. APIのアカウントを作ります(個人か会社)。
  2. 支払い方法を登録し、米ドルを入れます。サブスクやプランは要りません。
  3. コンソールでAPIキーを作ります。「全文は一度しか表示されない」ので、すぐに保存します。
  4. PythonかTypeScriptのSDK、または任意の言語のHTTPクライアントで、api.higgsfield.ai にリクエストします。各モデルのページに、サンプルのコードがあります。Claude Code、Cursor、ChatGPT(Codex)向けの、セットアップ用の指示も用意されている、と書かれています。
  5. カタログで、モデルを選びます。ページに、現在のレート、対応する解像度と長さが出ます。
  6. 提出して、追跡します(下)。
  7. 完成したファイルは、最低7日は保管されるので、自分の保管先に保存します。

  8. コンソールのURL。 ヘルプのAPIの記事とOfficial platformsの記事は open.higgsfield.ai、APIドキュメントの冒頭とクイックスタートは console.higgsfield.ai を案内しています。どちらが現行か、確認できていません。

  9. 認証。 ドキュメントの要約は、サーバー側で使うキーを、コンソールで作って管理し、Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET} の形で送る、と書いています。クイックスタートは、この認証情報はアカウントへのアクセスを与えるので、サーバー側のコードだけで使い、ソース管理に入れない、と書いています。

手順:REST APIの最初の1回(ドキュメントのクイックスタートの記載)

前提:コンソールのアカウント、キーのIDとシークレット、curl と jq。コマンドの全文は、実行の前にクイックスタートの原文で確認してください(要約から組み直したものを、公式の写しとは言えないため、要点だけを書きます)。

  1. 環境変数に、HF_API_KEY_ID、HF_API_KEY_SECRET、そして重複を防ぐ IDEMPOTENCY_KEY(uuidgen で作る小文字のUUID)を設定します。
  2. POST https://api.higgsfield.ai/higgsfield-ai/soul/v2/standard に、Authorization: Key ...、Content-Type: application/json、Idempotency-Key: ... のヘッダと、{"prompt": "..."} の本文を送ります(クイックスタートの例のプロンプトは、朝の高山の湖の編集写真風)。
  3. 返事は、すぐに返り、status が queued、request_id、status_url、cancel_url が入っています。
  4. GET https://api.higgsfield.ai/requests/{request_id}/status を、Authorization つきで、終わりの状態になるまで繰り返します。完成した画像は、images の配列の url に入ります。

リクエストの状態と取り消し(ドキュメントの記載)

状態は queued(待ち。取り消せる)、in_progress(開始。取り消せない)、終わりの状態の completed(出力のURLが入る)、failed、nsfw(内容のチェックで拒否)、canceled です。提出の返事の request_id はすぐ保存し、URLは自分で組まず、返事のものを使います。取り消せるのは、処理が始まる前(queued)だけで、成功は 202 Accepted(本文は空)、処理が始まったあとは 400 Bad Request です。取り消しのURLは、提出の返事の cancel_url を使います。Idempotency-Key を付けておくと、タイムアウトのときに同じキーで再送して、重複した依頼を作らずに済みます。リクエストの本文は、モデルごとに違います。

手順:入力のファイルを渡す(ドキュメントの記載)

  1. POST https://api.higgsfield.ai/files/generate-upload-url に、content_type(例:image/jpeg)を送る。返事に、public_url、upload_url、content_type、upload_headers が入る。
  2. upload_url に、upload_headers のすべてを付けて PUT する。Higgsfieldの認証情報を、この保存先のURLに送らない、と書かれています。
  3. public_url を、モデルの引数(image_url、video_url、audio_url)に渡す。

  4. 形式:画像はJPEG、JPG、PNG、WebP、GIF。音声はWAV。動画はMP4。署名つきのURLは、作成から1時間で切れます。ファイルの大きさの上限は、書かれていません。

料金と制限(ヘルプの記載、確認日 2026-10-25)

読めなかった資料

2026年10月25日の作業中にWebFetchの時間あたりの上限に当たり、APIドキュメントの Authentication、SDK、Webhooks、Rate limits、FAQ は読めていません。SDKのパッケージ名、Webhookの設定、キーの取り消しは、この記事に書いていません。ドキュメントの目次に、MCPやClaude、ChatGPTなどのエージェント専用のページはありませんでした。

F. AI同士の組み合わせ(その2)

チャット系の組み合わせ(Claude × Higgsfieldの動画づくり、広告の素材づくり)は、07のFにあります。ここでは残りです。

G. 外し方のまとめ

H. うまくいかないときの確認点

気をつけること

公式の資料では確認できていない点

出典