mcpField
H
higgsfield-operator

higgsfield-operator

github.com/jmsktmクリエイティブ・メディア1087 回インストール40 週間前に更新
リポジトリ

higgsfield-operator について

Higgsfield での AI 動画生成を扱う実用ガイドです。統合モデル、カメラプリセット、VFX、キャラクターの一貫性、トーキングヘッドのワークフロー、Python SDK を取り上げ、動画制作や自動化を計画するクリエイターや開発者を対象としています。

主な機能

  1. 01統合された動画モデルの比較
  2. 02カメラプリセットを使った画像から動画の生成
  3. 03Soul ID によるキャラクターの一貫性維持
  4. 04プリセット VFX とカメラ動作の適用
  5. 05リップシンク付きトーキングヘッド動画の生成
  6. 06Python SDK による生成の自動化

活用シーン

  1. 01静止画からシネマティックなクリップを作成
  2. 02同じキャラクターを使ったキャンペーン動画の制作
  3. 03リップシンク付き広告や推薦動画の作成
  4. 04Python から動画生成を送信し状況を追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jmsktm/claude-settings --skill higgsfield-operator

インストール後、Claude Code で/higgsfield-operatorを入力して読み込まれたか確認します。

詳細

Higgsfield Operator

Higgsfield AI のマスターガイドです。70 種類以上のシネマティックなカメラプリセット、23 種類以上の VFX エフェクトを備え、Sora 2、Google Veo 3.1、WAN 2.5、Kling 2.6 などと連携するマルチモデル動画生成プラットフォームです。このスキルでは、基本的な画像から動画への生成から高度な制作ワークフローまで、すべてを解説します。

プラットフォームの概要

Higgsfield は、15 種類以上のプレミアム AI 動画モデルを 1 つのプラットフォームに集約しています。

  • OpenAI Sora 2 / Sora 2 Pro - 複数シーンに対応したテキストから動画への生成
  • Google Veo 3.1 - トーキングヘッド向け UGC Builder
  • WAN 2.5 - カメラ操作に対応した音声同期動画
  • Kling 2.6 - 高忠実度の動画生成
  • Nano Banana Pro - 高速生成(Ultimate+ では無制限)

主な差別化要因: 単一モデルのツールとは異なり、Higgsfield はクラス最高の AI モデルに、プロ向けの操作機能(カメラシミュレーション、キャラクターの一貫性、リップシンク)を組み合わせています。

このスキルを使う場面

次のような場合に、このスキルを使います。

  • AI 生成動画コンテンツ(ソーシャル、広告、コンテンツ)を作成する
  • 静止画像にシネマティックなカメラワークを適用する
  • グリーンスクリーンやポストプロダクションを使わずに VFX を追加する
  • 複数の動画でキャラクターの一貫性を維持する(Soul ID)
  • リップシンク付きのトーキングヘッド動画を作成する
  • Python SDK を使って動画生成を自動化する
  • Higgsfield に統合されたモデルから選択する

次の用途にはおすすめしません。

  • リアルタイム動画編集(従来の NLE を使用してください)
  • 1 分を超える動画(現在の AI 動画の制限)
  • フレーム単位の厳密な操作(AI が自律的に生成します)

クイックリファレンス

操作方法/ツール
画像から動画画像をアップロード + カメラプリセットを選択
テキストから動画テキストプロンプトで Sora 2 または WAN 2.5 を使用
キャラクターの一貫性Soul ID(参照写真を 10 枚以上アップロード)
トーキングヘッドUGC Builder(Veo 3.1)+ Lipsync Studio
VFX の適用23 種類以上のプリセットからエフェクトを選択
API 生成Python SDK higgsfield-client

主なワークフロー

ワークフロー 1:カメラワークを使った画像から動画への生成

目標: 静止画像をシネマティックな動画クリップに変換する

手順:

  1. 高品質な元画像をアップロードします(1024x1024 以上を推奨)
  2. 70 種類以上の選択肢からカメラプリセットを選びます
  3. 必要に応じて、最大 3 つの動きを重ねます
  4. アスペクト比(16:9、9:16、1:1)を選びます
  5. 生成してダウンロードします

カメラプリセットのカテゴリー:

カテゴリー例最適な用途
ドリードリーイン、ドリーアウト、ドリーズーム商品のお披露目、強調
パンウィップパン、左/右パンシーンの切り替え、お披露目
ティルト上/下ティルト、ダッチティルトドラマチックなお披露目、ホラー
トラッキングトラッキングショット、フォローショットアクション、追跡シーン
空撮FPV ドローン、クレーンショット、ヘリコプターエスタブリッシングショット
特殊バレットタイム、360 度回転、クラッシュズームアクション、スタイリッシュなコンテンツ
スタビライズ固定、固定フレーム会話、インタビュー

プロのヒント: 動きを重ねて複雑なモーションを作成します。クレーン + ドリーズーム + 回転で、クリストファー・ノーラン風の映像になります。


ワークフロー 2:Soul ID によるキャラクターの一貫性

目標: 複数の動画でキャラクターの外見を同一に保つ

手順:

  1. 鮮明な参照写真を 10 枚以上アップロードします
    • 異なる角度(正面、斜め 3/4、横顔)
    • さまざまな表情
    • できれば照明を統一
  2. システムが次の特徴を捉えたデジタルツインを作成します。
    • 顔の形と骨格
    • 髪型と髪色
    • 表情のパターン
    • 姿勢の特徴
  3. 50 種類以上のスタイルプリセット(Amalfi Summer、Gorpcore Outdoor、0.5 Selfie など)から選びます
  4. キャラクターの一貫性を保った動画を生成します

Soul ID を使ったプロンプトの例:

A young woman walks through a busy Tokyo street at night,
neon lights reflecting off wet pavement.
[Soul ID: @my-character]
Camera: Tracking Shot

使用例:

  • キャンペーンを通じて活躍するブランドアンバサダー
  • キャラクターを中心としたコンテンツシリーズ
  • 一貫した「クリエイター」が登場する UGC スタイルの広告
  • 繰り返し登場するキャラクターを使ったストーリーテリング

ワークフロー 3:VFX 効果の適用

目標: ポストプロダクションなしで、動画に大作映画のようなVFXを追加します

VFX 効果の一覧:

カテゴリー効果
爆発建物の爆発、クローンの爆発、頭部の爆発、プラズマ爆発、車の爆発
炎/熱火のエレメント、溶岩、花火、炎をまとう、炎のトランジション、火を吐く、炎上
変身金属化、サイボーグ化、動物化、神秘化、ゴリラへの変身、怪物化
分解分解、データモッシュ、モーフスキン
超能力雷神、透明化、輝く眼差し、浮遊、ヒーロー飛行、空を飛ぶ
自然大地のエレメント、地割れ、庭の開花、自然の開花、桜の花びら、オーロラ
トランジションディスプレイ・トランジション、フライングカメラ・トランジション、煙のトランジション、溶解トランジション、シームレス・トランジション
キャラクター黒い涙、光る魚、影の煙、触手、シンビオート、天使の翼
環境水族館、洪水、綿雲、お金の雨、ピザの落下
スタイルグリッチ、ポイントクラウド、ポリゴン、ポータル、聖なる輝き、ペイントスプラッシュ、粉塵爆発

コンビネーション効果(ベータ版):

  • アクションラン + 炎上
  • 建物の爆発 + 分解
  • カーチェイス + 建物の爆発
  • クラッシュズームイン + 顔面パンチ

適用手順:

  1. ソース画像をアップロードするか、動画を生成します
  2. ライブラリーからVFX効果を選択します
  3. プレビューして強度を調整します(利用可能な場合)
  4. カメラの動きと組み合わせます
  5. 最終出力を生成します

ワークフロー 4:トーキングヘッド動画(UGC Builder)

目標: 広告や推薦コメント用の、リアルなトーキングヘッドコンテンツを作成します

使用技術: Google Veo 3.1 + Lipsync Studio

手順:

  1. キャラクター画像をアップロードするか、Soul IDを使用します
  2. 台本テキストを入力するか、音声をアップロードします
  3. 音声を選択します(AI合成または音声クローン)
  4. スタイルプリセットを適用します(プロフェッショナル、カジュアル、エネルギッシュ)
  5. リップシンク動画を生成します

ベストプラクティス:

  • 最高の品質を得るには、クリップを30秒未満にします
  • 顔がはっきり写った、明るく照らされた画像を使用します
  • 自然で会話調の言葉遣いで台本を作成します
  • 複数の音声オプションを試します

ワークフロー 5:Python SDKとの連携

目標: プログラムで動画生成を自動化します

インストール:

pip install higgsfield-client

認証:

# Option 1: Combined key
export HF_KEY="your-api-key:your-api-secret"

# Option 2: Separate keys
export HF_API_KEY="your-api-key"
export HF_API_SECRET="your-api-secret"

認証情報はHiggsfield Cloudから取得してください

同期生成:

import higgsfield_client as hf

# Upload source image
image_url = hf.upload_file("./my-image.jpg")

# Generate video with camera preset
result = hf.subscribe(
    arguments={
        "image": image_url,
        "camera_preset": "dolly_in",
        "aspect_ratio": "16:9",
        "model": "wan_2.5"
    }
)

print(f"Video URL: {result['output_url']}")

ポーリングによる非同期生成:

import higgsfield_client as hf

# Submit request
controller = hf.submit(
    arguments={
        "prompt": "A futuristic city at sunset, flying cars",
        "model": "sora_2",
        "duration": 5
    }
)

# Poll for status
for status in hf.poll_request_status(controller.request_id):
    if isinstance(status, hf.Queued):
        print(f"Queue position: {status.position}")
    elif isinstance(status, hf.InProgress):
        print(f"Progress: {status.progress}%")
    elif isinstance(status, hf.Completed):
        print(f"Done! URL: {status.output_url}")
        break
    elif isinstance(status, hf.Failed):
        print(f"Error: {status.error}")
        break

Webhook通知:

result = hf.submit(
    arguments={...},
    webhook_url="https://your-server.com/webhook"
)

SDKメソッドのリファレンス:

メソッド説明
subscribe(args)送信し、完了まで待機します
submit(args)送信し、追跡用のコントローラーを取得します
status(request_id)リクエストのステータスを確認します
result(request_id)完了した結果を取得します
cancel(request_id)キュー内のリクエストをキャンセルします
upload(data, content_type)生バイトデータをアップロードします
upload_file(path)ファイルパスからアップロードします
upload_image(pil_image, format)PIL Imageをアップロードします

すべてのメソッドには、async/awaitで使用するための_asyncバリアントがあります。

ステータスの種類:

  • Queued - キューで待機中
  • InProgress - 生成中
  • Completed - 完了、出力を利用できます
  • Failed - 生成に失敗しました
  • NSFW - コンテンツにフラグが付けられました
  • Cancelled - ユーザーがキャンセルしました

カメラプリセット完全リファレンス

基本的な動き
プリセット動き使用例
固定動きなし会話、ポートレート
ドリーインカメラが被写体に近づく強調、親密さ
ドリーアウトカメラが遠ざかる周囲の環境を見せる
ドリーズームドリーと反対方向にズームめまい効果
左/右パン水平方向に回転シーンのスキャン
上/下ティルト垂直方向に回転高さを見せる
動きのある動作
プリセット動き用途
ウィップパン水平方向への素早いスナップシーンの切り替え
クラッシュズーム急速なズームイン驚き、強調
プッシュインゆっくり近づく緊張感の高まり
プルアウトゆっくり遠ざかる背景の提示
アークショット半円状の移動主役のショット
360度回転被写体の周りを一周製品紹介
空撮/特殊撮影
プリセット動き用途
FPVドローン一人称視点で飛行アクション、エクストリームスポーツ
クレーンショット垂直方向への上昇俯瞰ショット
ヘリコプター空からの旋回風景
バレットタイム時間を止めた状態で周回アクションの静止
ステディカム滑らかに追従歩行/会話
手持ち撮影わずかな揺れドキュメンタリー風
実験的(SOUL)
プリセット説明
エスカレーター動くエスカレーターからのPOV
ライブラリー本棚を追う撮影
ギャラリー美術館内を歩く撮影
ストリートビュー都市の道路目線
地下鉄地下鉄駅
富士山山の眺望
サンセットビーチビーチの夕日
フライトモード飛行機の窓
エンジェルウィング幻想的な浮遊
CCTV防犯カメラ

料金とクレジット

プラン月額料金クレジット主な機能
Free$01日の上限720p、ウォーターマーク、基本プリセット
Basic$9/mo150/mo1080p、ウォーターマークなし
Pro$29/mo600/moキューが高速化、より多くのモデル
Ultimate$49/mo1,200/moNano Banana Pro が無制限
Creator$249/mo6,000/mo優先レンダリング
Studioカスタムカスタムチームでの共同作業、API

クレジットパック: 1回限りの購入で、90日間有効です

モデルごとのクレジット消費量(概算):

モデル生成あたりのクレジット
Nano Banana5-10
WAN 2.515-25
Kling 2.620-30
Sora 230-50
Sora 2 Pro50-100
Veo 3.125-40

ベストプラクティス

画質
  • 1024x1024以上の解像度を使用します
  • ぼやけた画像や圧縮された画像は避けます
  • 元画像の照明が良好であれば、出力も向上します
  • 多くのプリセットでは、被写体を中央に配置するのが最適です
プロンプトエンジニアリング(テキストから動画を生成)
Good: "A golden retriever runs through autumn leaves
       in a forest, morning sunlight, slow motion"

Better: "A golden retriever runs joyfully through
        scattered autumn leaves in a sun-dappled forest,
        warm morning light filtering through trees,
        slow motion, cinematic depth of field,
        camera tracking shot"
Soul IDの最適化
  • 参照画像を最低10枚用意します
  • 顔全体、斜め45度、横顔を含めます
  • 表情に変化をつけます(笑顔、無表情、会話中)
  • 画像全体で照明を統一します
  • サングラスや帽子は避けます(キャラクターの特徴である場合を除く)
VFXの統合
  • 効果の強さをコンテンツの雰囲気に合わせます
  • 動画全体を生成する前にプレビューします
  • 効果を選択した後に、カメラの動きを重ねます
  • 被写体の種類によって、より効果的なエフェクトは異なります
APIの効率的な利用
  • 類似したリクエストをまとめて送信します
  • 生成に時間がかかる場合は、ウェブフックを使用します
  • 頻繁に使用する画像のアップロードをキャッシュします
  • ステータスのポーリングにはバックオフを適用します

トラブルシューティング

問題原因解決策
キャラクターの見た目が異なるSoul IDの参照画像が不足していますさらに5枚以上の、多様な写真を追加します
動画が短すぎるモデルまたはクレジットの制限プランをアップグレードするか、より長い動画を生成できるモデルを使用します
VFXが不自然に見える元画像の画質が低いより高解像度の元画像を使用します
生成に失敗するNSFW検出またはモデルエラープロンプトを書き換えるか、元画像を変更します
APIがタイムアウトするサーバーの負荷指数バックオフを適用して再試行します
キューの位置が変わらない需要が高いHiggsfieldのステータスページを確認します

モデル選択ガイド

ニーズ推奨モデル理由
最速で生成Nano Banana5-10秒
最高品質Sora 2 Pro最高の忠実度
トーキングヘッドVeo 3.1 + UGC Builderリップシンクが最適
音声同期WAN 2.5ネイティブの音声サポート
長尺(8秒以上)Sora 2長時間の生成
特定のスタイルKling 2.6スタイルの一貫性
予算重視WAN 2.5品質とコストのバランスが良好

統合例

Node.jsラッパー(fetchベース)
async function generateVideo(imageUrl, preset) {
  const response = await fetch('https://cloud.higgsfield.ai/api/generate', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.HF_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      image: imageUrl,
      camera_preset: preset,
      model: 'wan_2.5'
    })
  });
  return response.json();
}
Next.js APIルート
// app/api/higgsfield/route.ts
import { NextRequest, NextResponse } from 'next/server'

export async function POST(request: NextRequest) {
  const { imageUrl, preset } = await request.json()

  // Forward to Higgsfield API
  const result = await generateVideo(imageUrl, preset)

  return NextResponse.json(result)
}
ウェブフックハンドラー
// app/api/higgsfield-webhook/route.ts
export async function POST(request: NextRequest) {
  const event = await request.json()

  if (event.status === 'completed') {
    // Save video URL to database
    await db.videos.update({
      where: { requestId: event.request_id },
      data: {
        outputUrl: event.output_url,
        status: 'ready'
      }
    })
  }

  return NextResponse.json({ received: true })
}

リソース


このスキルは ID8Labs によってメンテナンスされています。最終更新日:2026-01-19

コメント