mcpField
V
videogencn

videogencn

github.com/agents365-aiクリエイティブ・メディア97372 回インストール2 週間前に更新
リポジトリ

videogencn について

videogencn は、Alibaba Cloud Bailian、Volcengine Ark、MiniMax、Tencent Hunyuan の中国語動画モデルで短いクリップを生成するスキルです。入力に応じてテキスト・画像・始終フレーム・参照画像の各モードを選び、生成後の MP4 をダウンロードします。

主な機能

  1. 014種類の動画生成モード
  2. 024つのプロバイダーに対応
  3. 03モードとモデルの自動選択
  4. 04長さ・解像度・画角の指定
  5. 05非同期生成と MP4 ダウンロード
  6. 06モデル一覧と比較ページ

活用シーン

  1. 01テキストプロンプトから短編を生成
  2. 02静止画をアニメーション化
  3. 032つのフレーム間の遷移を作成
  4. 04参照画像を使った動画生成

インストール

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

$npx skills add https://github.com/agents365-ai/365-skills --skill videogencn

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

docs/
videogen-workflow.drawio
scripts/
generate_video.py
scripts/providers/
__init__.py
bailian.py
base.py
hunyuan.py
jimeng.py
minimax.py
tests/
__init__.py
test_core.py

詳細

videogencn - 中国語動画生成スキル

概要

4つのプロバイダー(Alibaba Cloud Bailian(Wan/PixVerse/Kling/Vidu/HappyHorse)、Volcengine Ark(Jimeng/即梦)、MiniMax(海螺 AI)、Tencent Hunyuan(混元))の中国語動画モデルを使って、短い動画クリップを生成します。

入力に基づいて自動選択される4つのモードがあります。

モード入力デフォルトモデル
t2v テキストから動画プロンプトのみwan2.7-t2v-2026-04-25(Bailian)
i2v 画像から動画プロンプト + --imagewan2.6-i2v-flash(Bailian)
kf2v 始点・終点フレームプロンプト + --image + --last-framepixverse/pixverse-c1-kf2v(Bailian)
r2v 参照画像から動画プロンプト + --ref(画像1〜7枚)pixverse/pixverse-c1-r2v(Bailian)

動画生成は非同期です。送信 → 10秒ごとにポーリング → MP4をダウンロードします。結果のURLは24時間後に期限切れになるため、スクリプトは常にすぐにダウンロードします。

ローカル画像の場合:Wan/HappyHorseはbase64データURIを直接受け付けます。PixVerse/Kling/ViduはDashScope OSSに自動アップロードします(48時間)。Jimeng/Hunyuanはbase64を使用します。MiniMaxは独自のファイルAPI経由でアップロードします。

このスキルを使用するタイミング

  • ユーザーが生成视频 / 文生视频 / 图生视频 / 首尾帧 / 参考生视频を依頼した場合
  • ユーザーが中国語の動画モデルを指定した場合:万相/Wan、爱诗/PixVerse、可灵/Kling、Vidu、HappyHorse、即梦/Jimeng、海螺/MiniMax、混元/Hunyuan
  • Bロール、静止画のアニメーション、キャラクターの一貫性を保ったクリップ、またはフレーム間のトランジションが必要な場合
  • ユーザーがモデルの料金や機能について尋ねた場合、またはモデルの比較を希望した場合 → docs/models.html を開きます

ワークフロー

Step 0: プロンプトの調整(対話式)

スキップされない限り、t2v/i2vで実行します(§0.4を参照)。生成前にClaudeがユーザーのプロンプトを洗練します。

0.1 元の入力を分析する
項目確認内容
被写体誰/何か?外見、動作、表情
シーンどこか?背景、環境、雰囲気
ライティング時刻は?光の質は?(ゴールデンアワー、ネオン、柔らかな拡散光、逆光)
カメラショットの種類は?(クローズアップ、ワイド、空撮、トラッキング)。動きは?(ドリーイン、パン、オービット)
ムード/スタイル感情的なトーンは?ビジュアルスタイルは?(シネマティック、アニメ、ドキュメンタリー、シュール)
動き何がどう動くか?速度、方向、ダイナミクス
時間的要素シーケンスはあるか?始まり→中間→終わり?
0.2 洗練した3つの候補を作成する

表形式で3つの候補を提示します。

| # | 风格方向 | 优化后提示词 | 建议参数 |
|---|---------|-------------|---------|
| 1 | [风格名]  | [完整中文提示词] | 5s / 16:9 / 1080P |
| 2 | [风格名]  | [完整中文提示词] | 8s / 16:9 / 1080P |
| 3 | [风格名]  | [完整中文提示词] | 5s / 9:16 / 1080P |
  • 候補1:原意を忠実に保つ — 核となるアイデアを維持し、シネマティックなディテールを加える
  • 候補2:創造的に展開 — 異なる芸術的解釈を加える
  • 候補3:実用性を重視 — 縦型ショート動画向けに最適化する

プロンプト作成のルール:

  • 中国語で記述し、被写体と動作を先に書きます(最初の20文字が最も重要です)
  • 抽象的な概念(「豊作の感じ」)ではなく、具体的な視覚名詞(「黄金色の麦畑」)を使います
  • 動きを明確に記述します(「ゆっくりと寄る」「風に揺れる」)
  • 末尾にカメラやライティングの指示を加えます(「映画のようなカメラワーク」「逆光のシルエット」)
  • 150文字以内に収めます
  • Wan 2.7のマルチショットでは、第N个镜头[N-Ns]: 描述形式を使用します
0.3 ユーザーからのフィードバック
ユーザーの発言対応
「用第N个」/「N」候補Nをそのまま使用
「更诗意」/「更浪漫」詩的なトーンで再生成
「更简洁」要点だけに絞る
「加动态元素」動きやアクションを増やす
「改为夜景」/「下雪」などすべての候補にシーン変更を適用
「混合1和3」候補1の被写体と候補3のスタイルを組み合わせる
「直接用」/「不改了」調整をスキップ
その他のフィードバック適用して再生成

ユーザーが明示的に承認する(「好」「可以」「用这个」「生成吧」)まで繰り返します。

0.4 スキップ条件

ユーザーが「直接生成」/「不用优化」/「skip」と言った場合、プロンプトがすでに詳細な場合(80文字超)、またはモードがkf2v/r2vの場合は、調整をスキップします。

Step 1: モード、プロバイダー、モデルを決定する
  • モード:入力から自動検出します(t2v / i2v / kf2v / r2v)
  • プロバイダー:--provider {bailian,jimeng,minimax,hunyuan}、またはモデル名から自動検出します
  • モデル:--modelフラグ、またはモードに対応するプロバイダーのデフォルト
  • パラメーター:候補の提案、またはユーザー指定に基づく再生時間、解像度、アスペクト比
Step 2: 確認して生成する

最終的なコマンドを表示し、ユーザーに確認します。スクリプトを実行すると、タスクの完了まで処理が続き、MP4が保存されます。

Step 3: 生成

出力パス、ファイルサイズ、生成時間を報告してください。パスが指定されていない場合は、cwd に保存してください。

コストに関する注意:動画 API は出力の秒数に応じて課金されます。長い動画や多数のクリップを生成する場合は、ユーザーに確認してください。

プロバイダー

Alibaba Bailian 百炼

1 つの API キー(DASHSCOPE_API_KEY)で 5 つのモデルファミリーを利用できます。サードパーティモデル(PixVerse/Kling/Vidu/HappyHorse)は cn リージョン限定です。モデル:Wan(t2v/i2v、最大 15 秒)、PixVerse(全 4 モード、1~15 秒)、Kling(t2v/i2v/kf2v、omni では r2v にも対応)、Vidu(q3:音声付きで 1~16 秒、q2:1~10 秒)、HappyHorse(t2v/i2v、3~15 秒)。

Volcengine Ark(Jimeng 即梦)

https://ark.cn-beijing.volces.com/api/v3 経由で ARK_API_KEY を使用します。Seedance 2.0:t2v/i2v、最大 15 秒/2K、音声、リップシンク、カメラモーションに対応しています。アスペクト比:16:9、9:16、1:1、21:9。

MiniMax 海螺 AI

https://api.minimax.chat 経由で MINIMAX_API_KEY を使用します。MiniMax-H3(Hailuo 3.0):t2v/i2v、4~15 秒、768P/1080P(2K は直接 API 経由)、ネイティブのステレオ音声付きで 24fps に対応しています。旧世代の video-01:720P で 6 秒、プロンプトオプティマイザーはデフォルトで有効です(無効にするには --no-prompt-optimizer を指定します)。ホストの上書きには MINIMAX_API_BASE を使用します(例:CN は https://api.minimaxi.com、海外は https://api.minimax.io)。

Tencent Hunyuan 混元

TokenHub 経由で HUNYUAN_API_KEY を使用します。hy-video-1.5:t2v/i2v(5~10 秒、720P、--duration/--seed に対応)。実験的な i2v 専用モデル:yt-video-2.0、yt-video-fx、yt-video-humanactor。--resolution、--ratio、--audio、--camera-motion フラグにはまだ対応していません。

モデル選択ガイド

用途モデルプロバイダー
最高品質の t2v、複数ショットwan2.7-t2v-2026-04-25Bailian
素早いアクション/戦闘pixverse/pixverse-c1-t2vBailian
スマートな絵コンテ+音声kling/kling-v3-video-generationBailian
音声付きで最大 16 秒の長いクリップvidu/viduq3-pro_text2videoBailian
Douyin/XHS 向けショート動画doubao-seedance-2-0-260128Jimeng
滑らかな動き、自然な物理表現MiniMax-H3MiniMax
画像をアニメーション化(デフォルト)wan2.6-i2v-flashBailian
2 つのフレーム間をトランジションpixverse/pixverse-c1-kf2vBailian
キャラクター/被写体の一貫性pixverse/pixverse-c1-r2vBailian
低コストのドラフトwanx2.1-t2v-turbo、happyhorse-1.0-t2vBailian
Tencent で中国語の t2v/i2vhy-video-1.5Hunyuan
ポートレートアニメーション(実験的)yt-video-humanactorHunyuan

すべてのモデルカタログを表示するには、python scripts/generate_video.py --list-models を実行してください。

モデル比較ページ

ユーザーがモデルを比較したい場合、料金を確認したい場合、機能で絞り込みたい場合、またはモデルを選びたい場合:

ブラウザーで docs/models.html を開いてください。 サーバー不要の、単体で動作する静的ページです。open(macOS)または xdg-open(Linux)を使用します。

open docs/models.html

このページでは、プロバイダー、モード(文生/図生/首尾フレーム/参考生)、機能(音声/カメラ/複数ショット)で絞り込み、24 モデルすべての料金と機能を比較できます。

使用方法

# Text-to-Video (Bailian default)
python scripts/generate_video.py "一只柴犬在樱花树下奔跑,花瓣随风飘落,电影感镜头" shiba.mp4 \
  --duration 5 --resolution 1080P --ratio 16:9

# Image-to-Video
python scripts/generate_video.py "镜头缓缓推近,人物微笑" out.mp4 --image portrait.png

# First+Last Frame (kf2v)
python scripts/generate_video.py "花苞缓缓绽放成盛开的牡丹" bloom.mp4 \
  --image bud.png --last-frame bloom.png

# Reference-to-Video (r2v)
python scripts/generate_video.py "@girl 在 @cafe 里弹吉他" out.mp4 \
  --ref girl=girl.png --ref cafe=cafe.jpg

# Other providers
python scripts/generate_video.py "城市日落延时摄影" sunset.mp4 --provider jimeng --duration 10
python scripts/generate_video.py "海浪拍打礁石" ocean.mp4 --provider minimax --duration 6
python scripts/generate_video.py "金黄色的麦田在秋风中起伏" field.mp4 --provider hunyuan --duration 5

# Dry-run: preview request + cost estimate without submitting
python scripts/generate_video.py "一只柴犬在樱花树下奔跑" --dry-run

# Schema introspection (for agents)
python scripts/generate_video.py schema providers   # list all providers
python scripts/generate_video.py schema bailian     # list bailian models with capabilities

# JSON output (auto-detected when stdout is not a TTY; force with --format)
python scripts/generate_video.py --list-models --format json
python scripts/generate_video.py "海边的日落" out.mp4 --format json --provider jimeng

# Resume a task
python scripts/generate_video.py --task-id <task-id> out.mp4

# List all models
python scripts/generate_video.py --list-models

オプション

フラグ意味デフォルト
--providerbailian / jimeng / minimax / hunyuan自動検出
-m/--modelモデル名モードに応じて自動設定
-i/--image最初のフレーム画像(パス/URL)→ i2v—
--last-frame最後のフレーム画像 → kf2v(-i が必要)—
--ref参照画像 name=path_or_url。複数指定可能 → r2v—
-d/--duration秒数5
-r/--resolution360P/480P/540P/720P/1080P1080P
--ratio16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:916:9
-s/--sizeサイズ指定モデル向けの正確な W*H解像度と比率から設定
-n/--negativeネガティブプロンプト(Wan のみ)—
--no-prompt-extendプロンプトの書き換えを無効化(Wan のみ)拡張は有効
--no-prompt-optimizer組み込みプロンプトオプティマイザーを無効化(MiniMax のみ)オプティマイザーは有効
--audioPixVerse/Kling/Vidu/Jimeng で音声を有効化無効
--no-audioWan 音声モデルで無音出力にする音声は有効
--camera-motionカメラの動き(Jimeng Seedance 2.0 のみ)—
--seed再現性ランダム
--task-id既存のタスクのポーリングを再開—
--dry-runリクエスト本文とコスト見積もりを表示。送信はしません—
--formatjson または table(デフォルト:TTY では table、それ以外では json)自動
--list-modelsモデルを一覧表示して終了—
schema <resource>イントロスペクション:providers またはプロバイダー ID—

要件

pip install requests

環境変数

変数必須プロバイダー用途
DASHSCOPE_API_KEYはい(Bailian)Bailianhttps://bailian.console.aliyun.com/
DASHSCOPE_API_BASEいいえBailiancn(デフォルト)/ sg / us
DASHSCOPE_VIDEO_MODELいいえBailianデフォルトモデルの上書き
ARK_API_KEYはい(Jimeng)Jimenghttps://console.volcengine.com/ark/
MINIMAX_API_KEYはい(MiniMax)MiniMaxhttps://platform.minimax.io
MINIMAX_API_BASEいいえMiniMaxAPI ホストの上書き(中国:https://api.minimaxi.com、海外:https://api.minimax.io)
HUNYUAN_API_KEYはい(Hunyuan)Hunyuanhttps://console.cloud.tencent.com/hunyuan

サードパーティの Bailian モデルは cn リージョンのみで利用できます。

コメント