veo3-1

Veo 3.1 動画生成

使い方

スキルディレクトリに移動せず、ユーザーの現在の作業ディレクトリから実行します。

uv run scripts/generate_video.py --prompt "description" --filename "output.mp4" [--model MODEL] [--duration 4|6|8] [--aspect-ratio 16:9|9:16] [--api-key KEY]

--url-only を使用すると、ダウンロードを省略して動画の URL のみを出力します。他のツールと連携する場合に便利です。

uv run scripts/generate_video.py --prompt "description" --url-only [--model MODEL] [--duration 4|6|8]

ワークフロー（ドラフト → 最終版）

1. ドラフト — --model veo3.1-fast --duration 4（最も低コスト。プロンプトを調整します）
2. 最終版 — --model veo3.1-pro-4k --duration 8（プロンプトが確定した場合にのみ使用します）

モデルのオプション

モデル	品質	解像度	コスト
veo3.1-fast（デフォルト）	高速	720p	最低
veo3.1-fast-1080p	高速	1080p	低
veo3.1-fast-4k	高速	4K	中
veo3.1-pro	プロ	720p	中
veo3.1-pro-1080p	プロ	1080p	高
veo3.1-pro-4k	プロ	4K	最高

ユーザーのリクエストに応じて、次のように選択します。

• 指定なし／「draft」／「fast」 → veo3.1-fast
• 「1080p」／「HD」 → veo3.1-fast-1080p
• 「4K」／「ultra」 → veo3.1-fast-4k
• 「high quality」／「pro」 → veo3.1-pro
• 「best quality」／「pro 4K」 → veo3.1-pro-4k

長さとアスペクト比

• 長さ：4 秒（ドラフト）、6 秒、8 秒（デフォルト／最終版）
• アスペクト比：16:9（デフォルト、横向き）、9:16（縦向き／モバイル）

API キー

--api-key 引数で指定するか、環境変数 GRSAI_API_KEY を設定します。

トラブルシューティング

症状	解決方法
Error: No API key provided.	環境変数 GRSAI_API_KEY を設定するか、--api-key を指定します
HTTP 401	API キーが間違っているか、有効期限が切れています
Generation failed:	コンテンツモデレーションまたは入力が無効です。プロンプトを言い換えてください
タイムアウト	より高速なモデル（veo3.1-fast）を使用するか、長さを短くします（--duration 4）
uv: command not found	インストールします：curl -LsSf https://astral.sh/uv/install.sh | sh を実行してから、ターミナルを再起動します

一時的なエラー（HTTP 429、ネットワークのタイムアウト）が発生した場合は、30 秒後に一度再試行します。再試行は 2 回を超えないでください。それ以上の場合は、問題をユーザーに伝えてください。

ファイル名の規則

形式：yyyy-mm-dd-hh-mm-ss-descriptive-name.mp4

• 2025-11-23-14-23-05-sunset-mountains.mp4
• 2025-11-23-15-30-12-dancing-robot-neon.mp4

出力

生成後は必ず、VIDEO_URL: <full_url> を単独の行に出力します。連携に使用する URL はここから抽出してください。

--url-only を指定しない場合：ファイルをディスクに保存し、Video saved: <path> を出力します。保存先のパスをユーザーに伝えてください。動画を開いたり、読み込んだりしないでください。

--url-only を指定した場合：生成情報と VIDEO_URL: の行のみを出力します。ダウンロードは行わず、--filename も不要です。

qwen-3-5-plus-video-feedback との連携

標準出力から URL を抽出し、そのままフィードバックスキルに渡します。

VIDEO_URL=$(uv run veo3-1/scripts/generate_video.py --prompt "..." --url-only | grep '^VIDEO_URL:' | cut -d' ' -f2)
uv run qwen-3-5-plus-openrouter/scripts/analyze_video.py --video-url "$VIDEO_URL" --prompt "Does this video match the prompt? Rate quality 1-10."

例

uv run scripts/generate_video.py --prompt "A golden sunset over mountain peaks with birds flying" --filename "2025-11-23-14-23-05-sunset-draft.mp4" --model veo3.1-fast --duration 4

uv run scripts/generate_video.py --prompt "Close-up of waves crashing on rocky shore, slow motion, cinematic" --filename "2025-11-23-15-30-12-ocean-waves.mp4" --model veo3.1-pro-4k --duration 8 --aspect-ratio 16:9