higgsfield

Higgsfield MCP

1つのコネクターで30以上のモデルを利用できます。サブスクリプションのクレジットで課金されるため、プロバイダーごとの API キーは不要です。

このスキルを使うタイミング

ユーザーがすでに Higgsfield のサブスクリプションに加入している場合に限り、このスキルを使ってください。このスキルの価値は、すでに料金を支払っているクレジットを使い、1つの認証で30以上のモデルにアクセスできる点にあります。1つのプロジェクトのためだけに、未加入のユーザーに加入を勧めないでください。

3つの機能

このスキルでできることは次の3つです。対象をこれらに絞ってください。

1. モデルを調べる — 利用可能なモデルと、それぞれのモデルが受け付ける役割
2. 画像を生成する — 単一またはバッチで生成
3. 動画を生成する — 画像から動画への連続処理を含む

インストール

接続方法は2つあります。 どちらも、認証済みでセッションから呼び出せる MCP に接続します。

ターミナル（Claude Code）：

claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

その後、セッションで /mcp を実行し、サブスクリプションを契約している Higgsfield アカウントで OAuth 認証を完了してください。

Claude Desktop アプリ：

Settings → Connectors → Add custom connector → https://mcp.higgsfield.ai/mcp を貼り付け → サインインします。

認証後の必須手順：

select_workspace

ワークスペースを選択するまで、生成の呼び出しはエラーが表示されずに失敗します。セッションの開始時に必ず一度実行してください。

注意： 新規インストール後、実行中のセッションに MCP ツールが表示されないことがあります。/mcp に higgsfield connected と表示されているのにツールが見えない場合は、Claude Code / Desktop を再起動してください。

管理が必要な API キーはありません。.env も不要です。認証は MCP が処理します。

生成前に必ずクレジット費用を提示する

必須事項です。 generate_image または generate_video を呼び出す前に、次の内容を提示してください。

• モデルと設定
• 推定クレジット費用（下の表を使用）
• 現在の balance
• 呼び出し後の残高

実行する前に、明示的な「go」を待ってください。クレジットは無料ではありません。事前に伝えずに消費するのは、信頼を損なう最大の原因です。自動モードでも、このルールは適用されます。

費用表（ドキュメントではなく実測値）

models_explore はクレジット費用を返しません。API に含まれていないためです。以下の固定表を使用してください。

モデル	設定	クレジット
gpt_image_2	2K medium	約3
nano_banana_2	2K	約11
seedance_1_5	480p、4秒	約2.4
seedance_1_5	480p、12秒	約7.2
より上位の動画	—	未確認（初回実行時に測定）

数値は変動します。 実行結果が不自然に感じられた場合は、Higgsfield ダッシュボードで確認してください。新たに測定した値があれば、この表を更新してください。

プランの階層によってモデルが通知なく制限される

上位モデル（例：seedance_2_0）は Starter ではブロックされ、役に立つエラーではなく、一般的な「Something went wrong」というメッセージが返されます。モデルで原因不明のエラーが出る場合は、プロンプトのデバッグを始める前に、プランによる制限を疑ってください。ユーザーのプランを推測するために、balance の確認を提案してください。

ワークフローの仕組み

アップロードは1ステップではなく3ステップです。 繰り返し呼び出す場合は、単一のヘルパーにまとめてください。

1. media_upload → 署名付き PUT URL と media_id を返します
2. curl -X PUT でファイルのバイト列をその URL に送信します
3. media_confirm({ media_id }) → メディアを使用可能な状態にします

生成は非同期です。

1. generate_image または generate_video を呼び出す → job_id を返します
2. job_status({ job_id, sync: true }) をポーリングします — 通常は1～2回のポーリングで完了します（画像は約10～20秒、動画はそれ以上）

結果のフィールド： 必ず rawUrl（PNG / 元データ）を取得してください。minUrl は WebP のプレビューにすぎません。

1つの参照を複数の生成で使用できます — アップロードした media_id はセッション中保持されます。再アップロードせず、呼び出し間で再利用してください。

並列ジョブも問題なく動作します — 複数の generate_image を呼び出し、それぞれを個別にポーリングしてください。

参照の受け渡し

スキーマは medias: [{ value, role }] です（reference_images ではありません）。value は次の3つの形式を受け付けます。

• media_id — media_upload / media_confirm から取得
• job_id — 前の生成の出力で、次の生成の入力として使用します。画像から動画への連続処理における大きな利点です — 静止画を生成し、再アップロードせずに、その job_id をそのまま generate_video に渡せます。
• https:// URL — 公開されている任意の画像 URL

モデルごとにロールの種類が異なります

呼び出しを作成する前に、必ずモデルに対して models_explore action=get を実行してください。ロールはモデルごとに異なります。

モデル	使用できるロール
Seedance 1.5	start_image、end_image
Seedance 2.0	全種類（image、start_image、end_image、video、audio）
Kling 3.0	start_image のみ
Nano Banana Pro / GPT Image 2	image

誤ったロールを渡すと、呼び出しは拒否されます。

Seedance 1.5 の時間指定に関する注意点

duration を省略すると、Seedance 1.5 は12秒をデフォルトとして使用します。これは4秒のクリップの3倍のコストです。必ず duration を明示してください。

料金に関する注記

• **Plus プラン：**月額 $39、1000 クレジット — 広告制作のワークロードに最適です
• 追加購入パック（100クレジットあたり $5）は90日で失効します — 買いだめしないでください
• ワークフローの切り替えを決定する前に、Higgsfield ダッシュボードで呼び出しごとの正確なクレジット消費量を確認してください

失敗時のルール

• ref-to-video から text-to-video へ、黙ってフォールバックしないでください — ビジュアルの基準を失うとワークフローの目的が損なわれます。失敗を明示してください。
• コンテンツポリシーのチェックに引っかかった場合、同じモデルで同じ入力を再試行しないでください — 入力またはモデルの変更を提案してください。
• MCP でエラーが発生した場合は、/mcp を確認して接続がまだ有効か確かめてください。サブスクリプションが失効すると、認証に問題が生じます。

利用可能なモデル

1つの URL で30種類以上を利用できます。主なモデルは次のとおりです。

カテゴリ	モデル
画像	Nano Banana Pro、GPT Image 2、Flux、Seedream
動画	Seedance 2.0、Sora 2、Veo、Kling、Hailuo
Higgsfield 独自モデル	Soul（キャラクターの一貫性）、Cinema Studio

**上限：**画像は最大4K、動画は最大15秒。