vidu-skills

Vidu の生成とアセットのワークフロー

vidu-cli v0.2.36 以降を使用してください。このスキルは v0.2.36（6bb4b07）に対応しています。初回使用時に vidu-cli --version を確認し、古いバージョンを使用している場合は、互換性のための代替策を考案するのではなく、アップグレードを依頼してください。

実行モデル

ホストのコマンド実行ツールを使って CLI を呼び出してください。サポートされている場合は argv 配列を優先してください。ホストがシェルコマンドを受け付ける場合は、引数を適切に引用符で囲み、複雑なコンテンツにはプロンプトファイルやタイムラインファイルを使用してください。一括オーケストレーションツールは必要ありません。生の API リクエストボディではなく CLI フラグを使用してください。タイムライン JSON の合成は CLI がサポートする入力です。

エージェントでは、デフォルトの JSON 出力を維持してください。--format table は人による確認用です。終了ステータス、stdout、stderr は個別に解析してください。引数エラーは stderr にテキストで出力され、実行時エラーは通常 ok: false の JSON を返します。エラーと再試行を参照してください。

環境変数：VIDU_TOKEN は必須です。VIDU_BASE_URL のデフォルト値は https://service.vidu.cn です。海外アカウントでは https://service.vidu.com を使用します。任意の VIDU_DEBUG=1 を設定すると、レスポンスボディが stderr に出力されます。インストールや認証情報の問題については、セットアップを参照してください。

ワークフローを選択する

ユーザーの目的	コマンド／リファレンス
画像または動画を生成する	task submit --type ... --model-version ...。タスク／モデルの対応表、参照の上限、デフォルト値については、パラメーターを参照してください。
音声またはリップシンクを生成する	task tts または task lip-sync。パラメーターを参照してください。公式の音声 ID は task tts-voices／task lip-sync-voices から選択してください。
動画／音声／字幕／エフェクトのトラックを合成する	task compose --timeline ...。タイムラインを作成する前に、合成を参照してください。
タスクを検索、確認、待機、またはダウンロードする	task list、task get --details、task wait。タスクのワークフローを参照してください。
タスクをキャンセル／削除、再実行、延長、または生成物を高画質化する	task cancel/delete/rerun/extend/upscale-image/upscale。タスクのワークフローを参照してください。
参照用の要素を作成／管理する、または生成物を閲覧／お気に入りに登録する	element ...、creation ...。アセットを参照してください。
個人用音声をクローン／管理し、TTS に使用する	voice create/list/get/update/wait。音声を参照してください。
クォータ、クレジット、取引履歴、または見積もりを確認する	quota pass/credit/records、task cost/tts-cost/lip-sync-cost。パラメーターを参照してください。動画の高画質化の見積もりには task upscale-cost を使用します。詳細はタスクのワークフローに記載されています。
再利用可能な画像をアップロードする	upload <local_image_path> は upload_id と ssupload_uri を返します。画像入力フラグを使って自動アップロードすることもできます。

基本ルール

• ユーザーが選択したモデルを尊重してください。新しいモデルが利用可能という理由だけで、デフォルトを切り替えないでください。モデル固有の設定を追加する前に、モデルマトリックスを確認してください。
• 入力ごとに --image、--material、--audio、--video を繰り返し指定してください。各素材は1つの name:id:version 引数です。素材をカンマで連結しないでください。
• 入力要件はモデルによって異なります。Q4 は音声のみの参照に対応し、Drama と Wan 3 は制限が異なるマルチモーダル参照に対応しています。すべての参照タスクに従来の画像／素材数の制限を適用しないでください。
• --audio は参照音声を指定します。--with-audio は出力音声を有効にし、対応する動画モデルでは --with-audio=false で無効にします。省略した場合は既存の動作が維持されます。引用と送信では、同じ音声選択を使用してください。
• スケジュールモード：nopeak = オフピークモード（闲时模式）、claw_pass = パスモード（通行证模式）、normal = クレジットモード（积分模式）。利用可否とオフピークの適用条件／割当量は、モデルとサーバーによって異なります。拒否された後に、明示的に選択されたモードを自動的に変更しないでください。
• 画像タスクに所要時間の指定は不要です。element create に所要時間オプションはありません。Drama／Wan 3 には動画のデフォルト設定があります。古い送信モデルでは、該当する場合、引き続き所要時間／解像度を明示的に指定する必要があります。
• --prompt-file は --prompt-path のエイリアスです。--model は --model-version のエイリアスです。対応している場合、--voice は --voice-id のエイリアスです。例では完全な名前を優先してください。
• タスク ID、数値の作成 ID、エレメント ID／バージョン、個人用の voice_... ID はレスポンスから取得するものであり、相互に置き換えることはできません。
• 生成時はデフォルトで task_id が返されます。ユーザーが完成した成果物を必要としている場合は、単一タスクには --wait --output ./results を優先してください。バッチの場合は、各タスクを送信してすべての ID を保存し、その後、個別に待機してください。
• タスクの送信時、--timeout と --output の使用には --wait が必要です。複数の成果物、または音声と字幕にはディレクトリを使用してください。単一の成果物にはファイルパスを指定できます。
• 待機中のタイムアウトや中断によって、サーバー上のタスクがキャンセルされることはありません。元の ID を使って続行してください。送信の失敗が不明確な場合に、やみくもに再送信しないでください。また、失敗した音声の試行を有料のクローンに切り替えないでください。

よくある形式

# The user's chosen model; legacy required settings remain explicit.
vidu-cli task submit --type text2video --prompt "A cat walking through rain" \
  --model-version 3.2 --duration 5 --resolution 1080p --wait --output ./results

# Explicit request for a Wan 3 video with generated audio.
vidu-cli task submit --type text2video --prompt "Waves breaking on a beach" \
  --model-version viduq2-drama-std --with-audio --wait --output ./results

# Resume an existing task; TASK_ID must come from a response.
vidu-cli task wait "$TASK_ID" --timeout 1800 --output ./results

task download、トップレベルの reference、voice delete、task submit --type tts コマンドはありません。上記でサポートされているワークフローのみを使用してください。インストール済みの CLI が異なる場合は、該当する --help を確認してください。フラグを推測したり、ユーザーのモデルや課金設定を黙って変更したりしないでください。