動画生成

listenhub video CLI を使って、テキストプロンプトや参考素材から AI 動画を生成します。静止画を動かす、既存のクリップを編集する、音声やテキスト読み上げでキャラクターの口を動かす、といったことができます。3 つのモデルファミリーが異なる用途をカバーします：HappyHorse、SeeDance、PixVerse。

トリガー

/video-gen でこの Skill を呼び出すか、次のいずれかのフレーズを使用します：

ListenHub Skills のインストールが必要です — はじめに を参照してください。

AI 生成のビジュアルにナレーションを付けた解説動画がほしい場合は、代わりに /explainer を使ってください。

簡単な例

Generate a video: cyberpunk city at night, 16:9, 5 seconds

AI はモードとパラメータを 1 問ずつ確認しながら進め、コストの見積もりを示し、生成前に確認を求めます。生成には数分かかります — ジョブはバックグラウンドで実行され、動画が完成すると AI が URL、長さ、解像度、消費クレジットとともに通知します。

モデル

用途に合わせてモデルを選びます。HappyHorse はデフォルトであり、既存の動画を編集できる唯一のファミリーです。SeeDance は末尾フレームと参考音声のサポートを追加します。PixVerse はリップシンクに対応する唯一のファミリーで、さらに一連の細かい単位の機能（mimic、restyle、fusion、transition、マーケティング agent）を備えています。

リップシンク、mimic、restyle、fusion、transition、マーケティング agent は PixVerse 専用です。HappyHorse と SeeDance では利用できません。

SeeDance のモデルバリエーション

SeeDance を選ぶ場合は、2 つのバリエーションから選択します：

モード

AI は手元にある参考素材にもとづいてモードへ振り分けます。HappyHorse と SeeDance は listenhub video create コマンドを共有します。PixVerse は listenhub openapi video pixverse generate を使い、--capability を明示的に指定します。

listenhub video create \
  --prompt "cyberpunk city at night, neon reflections on wet streets" \
  --model "happyhorse" \
  --resolution "1080p" \
  --ratio "16:9" \
  --duration 5 \
  --no-wait --json

listenhub video create \
  --prompt "bring the scene to life with smooth motion" \
  --model "happyhorse" \
  --resolution "1080p" \
  --duration 5 \
  --first-frame "/path/to/scene.png" \
  --no-wait --json

listenhub video create \
  --prompt "[Image 1]'s character walking through [Image 2]'s street" \
  --model "happyhorse" \
  --resolution "1080p" \
  --ratio "16:9" \
  --duration 5 \
  --reference-image "/path/to/character.png" \
  --reference-image "/path/to/scene.png" \
  --no-wait --json

listenhub openapi video pixverse generate \
  --capability lip_sync \
  --source-video-id "abc123" \
  --audio "https://example.com/voice.mp3" \
  --quality 720p \
  --no-wait --json

listenhub openapi video pixverse generate \
  --capability lip_sync \
  --source-task-id "task_xyz" \
  --pixverse-json '{"tts":{"speakerId":"speaker_01","content":"Welcome to this episode"}}' \
  --quality 720p \
  --no-wait --json

動画編集（HappyHorse）

既存のクリップを編集します — スタイルの変更、背景の差し替え、動きの作り直し。HappyHorse のみ対応で、SeeDance でこれを頼むと AI が HappyHorse に切り替えます。

動画の要件：mp4/mov（H.264 推奨）。入力は 3–60 秒（出力は最大 15 秒）。100 MB 以下。短辺 360px 以上、長辺 4096px 以下。任意で参考画像を 0–5 枚渡せます。

listenhub video create \
  --prompt "replace the background with a deep starry sky, keep the subject's motion" \
  --model "happyhorse" \
  --resolution "1080p" \
  --reference-video "/path/to/input.mp4" \
  --audio-setting "origin" \
  --no-wait --json

--audio-setting は音声を制御します：auto はモデルに判断を任せ、origin は元の音声を保持します。動画編集には --ratio と --duration がありません — 出力は入力動画に従います。

その他の PixVerse 機能

PixVerse は --capability を通じて、より細かい単位の機能を追加で公開しています。いずれも OpenAPI 専用で、入力は URL です：

パラメータ

AI はこれらを 1 つずつ尋ね、妥当なセッションのデフォルト値を適用します。HappyHorse と SeeDance では比率と長さに --ratio / --duration を使います。PixVerse は --resolution / --ratio の代わりに --quality と --aspect-ratio を使います。

PixVerse 専用のフラグ：--capability、--quality（360p/540p/720p/1080p）、--aspect-ratio（9:16/16:9/1:1/4:3/3:4）、--source-video-id / --source-task-id、--audio、--agent-type、--restyle-id、およびネストしたペイロード（tts、imageReferences、multiTransition）を渡す --pixverse-json。

クレジットの見積もり

生成の前に AI が見積もりを実行します。自分でコストを確認したい場合は、create のパラメータをそのまま estimate コマンドに対応させてください：

# HappyHorse / SeeDance
listenhub video estimate --model "happyhorse" --resolution "1080p" --ratio "16:9" --duration 5 --json

# PixVerse — mirror the capability + quality + duration
listenhub openapi video pixverse estimate --capability text_to_video --model pixverse --quality 720p --duration 5 --json

動画編集では、--has-video-input と --input-video-duration <seconds> を追加してください。

出力

ステータスは pending → generating → uploading → success と遷移します。成功すると AI は動画の URL、長さ、解像度、比率、seed、消費クレジットを報告します。

出力の挙動は、設定で指定した outputMode に従います：

• inline（デフォルト）または both — 動画の URL とメタデータが会話の中に直接表示されます。
• download または both — ファイルがトピックにもとづく名前（例：cyberpunk-city.mp4）でカレントディレクトリにも保存されます。名前の重複は自動的に回避されます。

過去の作業を振り返るには、listenhub video get <taskId> --json で単一のタスクを、listenhub video list --json で最近のタスク一覧を取得します。グローバルフラグも使えます：--json / -j、--no-wait、--timeout <s>。

API リファレンス

エンドポイントのパス、リクエストパラメータ、レスポンスフィールドについては、AI 動画 API リファレンス を参照してください。