veo3

Google Veo 3 API を利用して、テキストプロンプトから動画を生成する Node.js CLI ツール。 コマンドラインから手軽に高品質な AI 動画生成を実行し、ローカルに保存できます。

セットアップ

必要な環境

• Node.js 20 以上

インストール

npm install

API キーの設定

Google AI API キーを .env ファイルに設定してください。

cp .env.example .env

.env ファイルを編集し、API キーを記入します。

GOOGLE_API_KEY=your-api-key-here

API キーは Google AI Studio から取得できます。

ビルド

npm run build

使い方

基本的な実行

npm run generate -- "夕暮れの海岸を歩く猫"

オプション付きの実行

npm run generate -- "夕暮れの海岸を歩く猫" --model standard --resolution 1080p --duration 8

オプション一覧

オプション	短縮	型	選択肢	デフォルト	説明
--model	-m	string	fast, standard	standard	使用するモデル
--resolution	-r	string	720p, 1080p, 4K	720p	動画の解像度
--aspect	-a	string	16:9, 9:16	16:9	アスペクト比
--duration	-d	number	4, 6, 8	8	動画尺（秒）

環境変数によるデフォルト値の変更

.env ファイルで各パラメータのデフォルト値を設定できます。CLI 引数が優先されます。

変数名	説明	例
GOOGLE_API_KEY	Google AI API キー（必須）	your-api-key
VEO_MODEL	デフォルトのモデル	fast / standard
VEO_RESOLUTION	デフォルトの解像度	720p / 1080p / 4K
VEO_ASPECT	デフォルトのアスペクト比	16:9 / 9:16
VEO_DURATION	デフォルトの動画尺	4 / 6 / 8

設定の優先順位: CLI 引数 > 環境変数 (.env) > デフォルト値

パラメータ制約

解像度と動画尺の組み合わせには制約があります。

解像度	利用可能な動画尺	備考
720p	4, 6, 8 秒	制限なし
1080p	8 秒	8 秒のみ対応
4K	8 秒	8 秒のみ対応

不正な組み合わせを指定した場合は、実行前にエラーが表示されます。

モデルと料金

CLI 値	API モデル名	特徴	料金
fast	veo-3.1-fast-generate-preview	高速生成	$0.15/秒
standard	veo-3.1-generate-preview	高品質生成	$0.40/秒

出力

生成された動画は dist/ ディレクトリに以下の形式で保存されます。

• {タイムスタンプ}_{ランダム文字列}.mp4 - 動画ファイル
• {タイムスタンプ}_{ランダム文字列}.json - メタデータ（プロンプト、設定値、生成日時など）