videogencn について
videogencn は、Alibaba Cloud Bailian、Volcengine Ark、MiniMax、Tencent Hunyuan の中国語動画モデルで短いクリップを生成するスキルです。入力に応じてテキスト・画像・始終フレーム・参照画像の各モードを選び、生成後の MP4 をダウンロードします。
主な機能
- 014種類の動画生成モード
- 024つのプロバイダーに対応
- 03モードとモデルの自動選択
- 04長さ・解像度・画角の指定
- 05非同期生成と MP4 ダウンロード
- 06モデル一覧と比較ページ
活用シーン
- 01テキストプロンプトから短編を生成
- 02静止画をアニメーション化
- 032つのフレーム間の遷移を作成
- 04参照画像を使った動画生成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ agents365-ai/ 365-skills --skill videogencnインストール後、Claude Code で/videogencnを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
docs/videogen-workflow.drawioscripts/generate_video.pyscripts/providers/__init__.pybailian.pybase.pyhunyuan.pyjimeng.pyminimax.pytests/__init__.pytest_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 画像から動画 | プロンプト + --image | wan2.6-i2v-flash(Bailian) |
| kf2v 始点・終点フレーム | プロンプト + --image + --last-frame | pixverse/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-25 | Bailian |
| 素早いアクション/戦闘 | pixverse/pixverse-c1-t2v | Bailian |
| スマートな絵コンテ+音声 | kling/kling-v3-video-generation | Bailian |
| 音声付きで最大 16 秒の長いクリップ | vidu/viduq3-pro_text2video | Bailian |
| Douyin/XHS 向けショート動画 | doubao-seedance-2-0-260128 | Jimeng |
| 滑らかな動き、自然な物理表現 | MiniMax-H3 | MiniMax |
| 画像をアニメーション化(デフォルト) | wan2.6-i2v-flash | Bailian |
| 2 つのフレーム間をトランジション | pixverse/pixverse-c1-kf2v | Bailian |
| キャラクター/被写体の一貫性 | pixverse/pixverse-c1-r2v | Bailian |
| 低コストのドラフト | wanx2.1-t2v-turbo、happyhorse-1.0-t2v | Bailian |
| Tencent で中国語の t2v/i2v | hy-video-1.5 | Hunyuan |
| ポートレートアニメーション(実験的) | yt-video-humanactor | Hunyuan |
すべてのモデルカタログを表示するには、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
オプション
| フラグ | 意味 | デフォルト |
|---|---|---|
--provider | bailian / jimeng / minimax / hunyuan | 自動検出 |
-m/--model | モデル名 | モードに応じて自動設定 |
-i/--image | 最初のフレーム画像(パス/URL)→ i2v | — |
--last-frame | 最後のフレーム画像 → kf2v(-i が必要) | — |
--ref | 参照画像 name=path_or_url。複数指定可能 → r2v | — |
-d/--duration | 秒数 | 5 |
-r/--resolution | 360P/480P/540P/720P/1080P | 1080P |
--ratio | 16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 | 16:9 |
-s/--size | サイズ指定モデル向けの正確な W*H | 解像度と比率から設定 |
-n/--negative | ネガティブプロンプト(Wan のみ) | — |
--no-prompt-extend | プロンプトの書き換えを無効化(Wan のみ) | 拡張は有効 |
--no-prompt-optimizer | 組み込みプロンプトオプティマイザーを無効化(MiniMax のみ) | オプティマイザーは有効 |
--audio | PixVerse/Kling/Vidu/Jimeng で音声を有効化 | 無効 |
--no-audio | Wan 音声モデルで無音出力にする | 音声は有効 |
--camera-motion | カメラの動き(Jimeng Seedance 2.0 のみ) | — |
--seed | 再現性 | ランダム |
--task-id | 既存のタスクのポーリングを再開 | — |
--dry-run | リクエスト本文とコスト見積もりを表示。送信はしません | — |
--format | json または table(デフォルト:TTY では table、それ以外では json) | 自動 |
--list-models | モデルを一覧表示して終了 | — |
schema <resource> | イントロスペクション:providers またはプロバイダー ID | — |
要件
pip install requests
環境変数
| 変数 | 必須 | プロバイダー | 用途 |
|---|---|---|---|
DASHSCOPE_API_KEY | はい(Bailian) | Bailian | https://bailian.console.aliyun.com/ |
DASHSCOPE_API_BASE | いいえ | Bailian | cn(デフォルト)/ sg / us |
DASHSCOPE_VIDEO_MODEL | いいえ | Bailian | デフォルトモデルの上書き |
ARK_API_KEY | はい(Jimeng) | Jimeng | https://console.volcengine.com/ark/ |
MINIMAX_API_KEY | はい(MiniMax) | MiniMax | https://platform.minimax.io |
MINIMAX_API_BASE | いいえ | MiniMax | API ホストの上書き(中国:https://api.minimaxi.com、海外:https://api.minimax.io) |
HUNYUAN_API_KEY | はい(Hunyuan) | Hunyuan | https://console.cloud.tencent.com/hunyuan |
サードパーティの Bailian モデルは cn リージョンのみで利用できます。