3行でいうと
- Webの流れは、公式のText to Videoのページが「書く、生成する、見直す、直す」と示しています。文章のひな形は「被写体+場所+動き+カメラ+光+音+形式」です。
- 画像から始めるときは、公式のImage to Videoのページが「画像を上げる、動きを書く、同じ画像から複数の候補を比べて直す」の3段を示しています。
- CLIの基本は
pixverse create video --prompt "…"です。作ったあとはpixverse task wait、pixverse asset downloadで受け取ります。公式のREADMEの例が根拠です。 - 例のプロンプトは、すべて「この記事の例」です。公式の例そのものではありません。
- 最初の1時間の並べ方(この記事の案)は、末尾にあります。クレジットを使うのは、生成を実行したときです。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。
手順は「公式のページに書かれている流れを、順に並べたもの」です。コマンドは公式のREADMEやスキルの記述にある例の写しです。要約を通して読んでいるため、細かい書式は公式ページで確認してください。「この記事の例」と書いたプロンプトや組み合わせは、公式の記載に合わせてこの記事で組んだもので、動作は確かめていません。画面の表記は変わります。手元の画面と照らして読んでください。
先に結論
- 文章は「短い演出メモ」のつもりで書きます。 公式は、あいまいな依頼を避け、短い演出メモのように具体的に書くことを紹介しています。
- 直すときは、結果を見てから、プロンプトか設定を変えます。 V6のページは、結果が安定しない原因として「あいまいな指示」「特徴の指定がない」「同時に多くの動きを求めすぎる」を挙げ、文章を具体的にして、不要なスタイルの言葉を減らし、動きの強さと長さの設定を見直すよう書いています。
- CLIでは、先に
capabilitiesで対応を見られます。 READMEによると、これはサインインもネットワークも要りません。 - Webの画面の中の操作(どこを押すか)は、公式の資料では確認できていません。 06では、ボタンの名前だけ、公式の製品ページに出てきたものを書きます。
前提:用語をそろえる
- プロンプト:作りたいものを説明する文章です。
- アスペクト比:画面の縦横の比です。16:9は横長、9:16は縦長です。
- シード(
--seed):同じ結果を再現しやすくするための数字です。READMEは「再現できる生成」と説明し、モデルごとに違うと書いています。 - タスク/ID:生成の注文と、その番号です。CLIでは
video_idなどが返ります。 - アセット:アカウントに保存された、作ったものや上げたものです。
- 参照素材(reference):人物や動きの手本にする画像・動画・音声です。CLIの
create referenceで使います。 @image1などの記法:参照素材をプロンプトの中で名指しする書き方です。READMEの例に出ています。
たとえ話
プロンプトは、撮影現場に渡す「カット割りメモ」です。「いい感じに」だけでは現場が迷い、「誰が、どこで、何をして、カメラはどう動き、どんな光と音か」を書くほど、受け取る側が迷いにくくなります。
場面1:文章から動画をつくる(Web)
公式のText to Videoのページ(pixverse.ai/en/product/text-to-video)に書かれている流れです。作る画面の中は読めていないため、画面上のボタンの位置や設定の名前は書きません。
手順
- pixverse.ai のText to Videoのページから、「Generate a Video From Text」(または「Try PixVerse」)のボタンで、作る画面(app.pixverse.ai)に進みます。サインインが必要な場合は「Login」から入ります(05を参照)。
- 作る画面で、文章から動画を作る入口を選びます。画面上の名前は、公式の資料では確認できていません。
- プロンプトを書きます。公式のひな形は、次のとおりです。
「subject + setting + action + camera + light + sound + format」(被写体+場所+動き+カメラ+光+音+形式)
- 被写体と場所:人、商品、部屋、風景、小物、アバターなど、場面の土台。
- 動きとカメラ:歩く、振り向く、開く、飛ぶ、注ぐ、変形するなどの動きと、push-in(寄る)、close-up、POV、tracking、aerial、handheld などのカメラ。
- 光、音、形式:照明、スタイル、音の指示と、9:16、16:9、1:1 などの出力形式。
- 長さ、解像度、アスペクト比を、使い道に合わせて生成の前に選びます。V6のページは、「長さ、解像度、アスペクト比を生成の前に決める」「縦のSNSなら1080pで9:16、横なら16:9」と書いています。
- 生成します。生成の前に画面の見積もり(クレジット)を見る案内は、01で読んだ別のモデルのページにあります。今回読んだText to VideoとV6のページには、この記述は見つかりませんでした(01を参照)。
- 結果を見て、プロンプトか設定を直して、もう一度生成します。公式は「複数の版と形式を試してから、最終に進める」と書いています。
この記事の例(プロンプト。公式の例ではありません)
公式のひな形に当てはめて、この記事で組んだ例です。
朝の駅前のカフェ。木のテーブルに置かれた白いマグカップから、湯気がゆっくり立ちのぼる。
カメラは正面から、ごくゆっくり寄っていく(push-in)。窓からやわらかい朝の光。
環境音は食器の小さな音と、遠くの電車の音。16:9。
- 何が返るか:動画が1本。内容は、モデルと条件で変わります。結果の質の保証は、公式の資料にもありません。
- 手元の結果が違ったときの直し方(公式のV6ページの方針):具体的に書き直す、不要なスタイルの言葉を減らす、動きを1つに絞る。
公式のV6ページが挙げる、カメラの言葉
公式のV6のページは、V6が反応しやすい言い方として、slow push-in、handheld tracking shot、low-angle shot、aerial view、POV、pan、tilt、orbit、close-up を挙げています。同じページは、人物の特徴(髪、服、アクセサリー、目立つ特徴)を、カットが変わっても同じ言葉で繰り返すよう書いています。
場面2:画像から動画をつくる(Web)
公式のImage to Videoのページ(pixverse.ai/en/product/image-to-video)の3段階です。
手順
- 「Generate from an Image」「Try Image to Video」などのボタンから作る画面に進みます(ページのボタン名)。
- 起点の画像を上げる。 公式は、商品画像、ポートレート、キャンペーンの静止画、イラスト、コンセプトのフレームなどを例に挙げ、被写体と方向性がはっきりした画像が、動きをつける土台になる、と書いています。V6のページは「被写体がはっきりしていて、輪郭が読みやすく、構図が強く、あいまいさの少ない画像」と書いています。ファイル形式や大きさの条件は、このページには書かれていません。
- 次に起きてほしい動きを書く。 公式の例では、ゆっくり寄る、現れる、繰り返す動き、動く背景、より映画のような雰囲気、などです。
- 同じ画像から複数の候補を作り、選んで直す。
公式の例にあるプロンプトの考え方
公式のページは、例として次の観点を挙げています(文面の引用ではなく、観点の要約です)。
- 入力画像を、見た目の基準かつ最初のフレームとして扱うよう指示する。
- 変えたくない要素(被写体の特徴、構図、光)を書く。
- カメラは、固定して少しだけ寄る、のように書く。
- 入れたくないもの(新しい動物や人物、物の複製、形が崩れること、文字、透かし)を書く。
- 物の動きの自然さや、カメラの揺れを避けることについての記述は、公式で確認できていません。
この記事の例(プロンプト。公式の例ではありません)
入力画像を最初のフレームとして使う。被写体(赤いマフラーの人物)、背景の石畳、夕方の光は変えない。
人物はゆっくりこちらを振り向き、マフラーが風でわずかに揺れる。
カメラは固定で、ごくゆっくり寄る。
新しい人物は出さない。顔や服の形を崩さない。文字や透かしを入れない。
場面3:スマホのアプリで作る
公式のダウンロードページには、「アプリでサインインすると、クレジットと作ったものが引き継がれる。数秒で最初の動画を作れる」という趣旨の記述があります。アプリの画面、メニュー、操作の順は、公式の資料では確認できていません。Webで書いた内容(プロンプトのひな形、見積もりを見る)は、アプリで同じ名前の機能があるかを手元の画面で確かめてから使ってください。
場面4:コマンドで動画をつくる(CLI)
ここからは、公式のREADMEにある例が中心です。入れ方とログインは05を参照してください。コマンドのオプションの値(モデル名、画質)は、版によって変わります。
4-1 作る前に、対応を調べる
pixverse capabilities create video --model v6 --json
- READMEは、
capabilitiesは「サインインもネットワークも要らない」と書いています。モデルごとの設定の範囲を調べるものです。 - スキルのSKILL.mdは、CLI 1.4.0以降で使える、古い版は
pixverse create video --helpを使う、と書いています。
4-2 最初の1本(READMEの例)
pixverse create video --prompt "A cat walking on Mars" --model v6 --quality 720p --aspect-ratio 16:9
- 入力:
--promptに文章、--modelにモデル名(V6はv6)、--qualityに画質、--aspect-ratioに縦横比。 - 返ってくるもの:
createは、既定では生成が終わるまで待つ、とSKILL.mdが書いています。待たずに戻りたいときは--no-waitを付け、返ってきたIDを控えて後で調べます。 - 待ち時間の上限:READMEの表では
--timeoutの既定は300秒(1以上)です。タイムアウトは、送信の失敗を意味しない、とSKILL.mdが書いています。同じものを慌てて再送しないよう、公式は求めています。
4-3 待つ、状態を見る、受け取る
pixverse task status <id>
pixverse task wait <id>
pixverse asset download <id>
pixverse asset download <id> --dest ./out/
task statusは状態を見る、task waitは終わるまで待つ、asset downloadで保存します。保存先は--destで指定できる例があります。- 音声のタスクは
--type audioが必要、とREADMEに書かれています。複数のIDをまとめて見るときはtask status 123 456 789 --type video --jsonの例があります。 - 保存するファイルの形式は、読んだ範囲では書かれていません。
4-4 JSONで受け取り、次のコマンドにつなぐ(READMEの例)
VID=$(pixverse create video --prompt "A cat on the moon" --json | jq -r '.video_id')
pixverse task wait "$VID" --json
pixverse asset download "$VID" --dest ./output/
--json(または-p)で、機械が読める出力になります。READMEには、create video --jsonの例に出るvideo_idと、テンプレート作成のoutputs以外、JSONのフィールドの定義は見つかりませんでした。jqは別の道具です。この例を動かすには、手元に必要です(公式のページに入れ方は書かれていません)。
4-5 プロンプトを文章ファイルや標準入力から渡す
READMEは、--prompt、--text、--lyrics は、文字列、ローカルファイルのパス(ファイルが存在する場合)、-(標準入力)のどれでもよい、と書いています。
pixverse create video --prompt ./scene.txt
cat scene.txt | pixverse create image --prompt - --json
長い指示を scene.txt に書いておけます。ページには、--prompt ./hooks.txt --count 4 の例もあります。
4-6 候補を複数作る、再現する、安い時間帯
| オプション | 公式の説明(READMEの表) |
|---|---|
--count |
作る数。1から4。既定1 |
--seed |
再現できる生成。モデルによる |
--off-peak |
オフピークでの生成。対応するモデルのみ |
--no-wait |
待たずに戻る |
--audio / --no-audio |
音声の生成。対応するモデルのみ |
--multi-shot / --no-multi-shot |
マルチショット。対応するモデルのみ |
--idempotency-key |
再送用の固定のキー(公式の表記は safe-retry key)。READMEの共通オプションの表にはなく、create-videoのスキルに記載 |
オフピークの料金や、何クレジット安くなるかは、読んだ範囲では書かれていません。
場面5:画像を作る、画像を直す(CLI)
READMEの例です。
pixverse create image --prompt "Cyberpunk cityscape at night" --aspect-ratio 16:9
pixverse create image --prompt "Turn this into a watercolor painting" --image ./photo.png
pixverse create image --model gemini-nano-banana-2.1 --detail-level high --prompt "A studio portrait"
- 画像のモデルの既定は、変更履歴によると、1.4.1以降は
gpt-image-2.5-flareです。 - 参照画像の最大枚数は、モデルごとにREADMEの表にあります(たとえば
gpt-image-2.5-flareは16、qwen-imageは3)。 - GPT Imageのモデルには
--background(auto、transparent、opaque)があり、GPT Image 2は対象外、とREADMEが書いています。 - 画質(
--quality)の値は、モデルごとに表で違います。
場面6:2枚の絵をつなぐ(トランジション)
pixverse create transition --images ./frame1.png ./frame2.png ./frame3.png
pixverse create transition -m seedance-2.5 --images ./first.png ./last.png --prompt "A seamless transformation"
- 画像を2枚以上並べます。Seedance 2.5のトランジションは、ちょうど2枚で、
--aspect-ratioを渡さない、とREADMEに注意があります。 - 画像の順番がつなぐ順番だと読めますが、READMEには明記がありませんでした。
場面7:参照素材から作る(人物・動き・声の手本)
READMEの例です。@image1、@video1、@audio1 のように、参照した順番で名指しします。
pixverse create reference -m v6 --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
pixverse create reference -m kling-o3-4k --images ./character.png --videos ./motion.mov --prompt "Use @image1 as the subject in @video1"
pixverse create reference -m seedance-2.5 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --duration auto --aspect-ratio auto --prompt "@image1 follows @video1 and @audio1"
- 入力できる数は、モデルごとに違います。READMEによると、V6は画像10枚と動画2本(合計15秒)まで、MiniMax H3 Maxは合計12(画像9、動画3、音声3)まで、Wan 3.0は合計20(画像10、動画5、音声5)まで、です。
- Seedance 2.5の参照モードには
--task-type(auto、reference、edit、extend)があります。 - 他人の顔や声、他人の著作物を入れるときの権利は、04を参照してください。
場面8:延ばす、直す、解像度を上げる、動きを移す
pixverse create extend --video <video_id>
pixverse create modify --video <video_id> --prompt "Change the background to a beach"
pixverse create upscale --video <video_id> --quality 2160p
pixverse create motion-control --image ./character.png --video ./dance.mp4
extendは長さを延ばす、modifyは既存の動画を直す、upscaleは解像度を上げる、motion-controlはキャラクター画像に手本の動画の動きを移す、とREADMEの注釈にあります。- 受け付けるモデルは、READMEの表の「Supported create modes」の列に載っています。たとえば
extendが書かれているのは、v6とgrok-imagineです。 upscaleで何クレジットかかるかは、読んだ範囲では書かれていません。
場面9:声、音楽を作る
pixverse create voice --text "Hello world" --voice-id <preset_voice_id> --output ./out.mp3
pixverse create music --prompt "A cinematic pop song with bright synths" --auto-lyrics
pixverse create music --prompt "Uplifting piano theme" --instrumental --duration-seconds 60
- 声のモデルは
speech-2.8-hd(既定)など、MiniMaxとElevenLabsのものが表にあります。速さは--speed(MiniMaxは0.5から2、ElevenLabsは0.7から1.2)です。 - 音楽は、歌詞に対応するモデルでは
--lyrics、--auto-lyrics、--instrumentalのどれかが必要、とREADMEにあります。 - どの声が使えるか(
--voice-idの値)の一覧は、READMEの要約には載っていませんでした。 - 声や音楽を作るモデルの提供元と、データの扱いは、PixVerseの資料には書かれていません(08を参照)。
場面10:テンプレート、ミニアプリ
pixverse template list
pixverse template search "dance"
pixverse template info <template_id>
pixverse create template --template-id 12345 --image ./photo.png
pixverse miniapps list
pixverse miniapps info magic_extend --json
- テンプレートは、入力の枠(スロット)が決まっています。
template info <id> --jsonで調べ、必要な画像を順に渡します。固定の出力設定のテンプレートは、画質や長さなどの指定を受け付けない、とREADMEにあります。 - ミニアプリの
createは、パラメータのJSONを--paramsで渡し、画像などは、あらかじめasset uploadで得たパスを使う、と書かれています。結果は--type miniappsを付けて、task waitやasset downloadで受け取ります(CLIのREADMEの記述)。
場面11:アセットとフォルダ
pixverse asset list
pixverse asset upload ./photo.png
pixverse asset info <id>
pixverse asset delete <id>
pixverse saved new "My Collection"
pixverse saved add <asset_id...> --folder <folder_id> --type video
asset listの既定は、作った動画です。画像は--type image、アップロードしたものは--source upload。- アップロードしたものは、ダウンロードできない、とREADMEにあります。
asset deleteで消したものが戻せるかは、読んだ範囲では書かれていません。
場面12:Canvas(作業場)を使う
Webでは、公式のCanvasのページ(pixverse.ai/en/canvas)が、5つのモード(Mind Layout、Batch Factory、Model Arena、Agent Launchpad、Project Memory)と、始め方の3段(方向を決める、場面と素材をつなぐ、文脈の中で生成して見直す)を書いています。作業の入口は「Open PixVerse Canvas」で、app.pixverse.ai/canvas に進みます。ページは、必要なプランを書いていません。
CLIにも canvas のコマンド群があります(CLI 1.4.0、2026-09-07から)。READMEの「Recommended sequence」(公式の表記)は、次の順です。
pixverse canvas project create --json
pixverse capabilities canvas --node-type image_generate --selector text_to_image --model qwen-image --json
pixverse canvas node schema --node-type image_generate --json
pixverse canvas graph get "$PROJECT_ID" --json
pixverse canvas patch dry-run "$PROJECT_ID" --patch patch.json --json
pixverse canvas patch apply "$PROJECT_ID" --patch patch.json --json
pixverse canvas dispatch "$PROJECT_ID" --node-ids image_01,video_01 --edit-version 13 --json
pixverse canvas graph status "$PROJECT_ID" --node-ids image_01,video_01 --json
capabilities createはネットワークを使わない照会ですが、capabilities canvasはネットワークを使う、とREADMEに書かれています。- 順に、プロジェクトを作る、使える設定を調べる、ノードの形を調べる、いまの図を読む、変更の案を試す(dry-run)、適用する、実行する、状態を見る、です。
patch.jsonの書き方、IDは文字列にすること、dispatchには明示的なノードIDと現在のedit_versionが要ること、などの規則があります。全文は公式のREADMEで確認してください。- この節は、AIエージェントに任せる使い方に向いた作りです(見立て)。手で打つ使い方の説明は、READMEには少なく、読んだ範囲で見つかりませんでした。
場面13:ChatGPT/Codexの中から使う
公式の紹介ページ(app.pixverse.ai/cli/gpt-astra)には、スキルのカード(例:Motion Design Video、Character Design Sheet、Ad Variant Maker、AI Presenter Video、Short Drama Film など)があり、各カードの「Try in ChatGPT」から、スキル名と依頼文があらかじめ入った新しいスレッドが開く、と読めました。依頼が自動で送信されるかは、ページに書かれていません。入れ方、データの扱いは08で扱います。
公式のV6ページが挙げる「うまくいかないとき」
| 症状 | 公式が挙げる原因 | 公式が挙げる直し方 |
|---|---|---|
| 実行のたびに結果がばらつく | あいまいな指示、人物の特徴の指定がない、競合する動きが多い | 文章を具体的に。人物の特徴を繰り返す。不要なスタイルの言葉を減らす |
| 動きの出方がおかしい | 公式は原因としてではなく、直し方の候補として「動きの強さと長さ」を挙げる | 動きの強さと長さの設定を調整する |
| 音のタイミングが合わない | 原因は書かれていない | 生成の後に音のタイミングを見直す、と書かれている(具体的な直し方は書かれていない)。プロンプトに音の合図を書く例はある |
最初の1時間にやる順番(この記事の案)
公式の手順ではなく、この記事で組んだ並べ方です。クレジットを使うのは、4から先です。
- 0〜10分: 05の手順で、入口を決める。Webだけで始めるなら、サインインして、見積もり(クレジット)の表示を見つける。CLIも使うなら、Node.jsのバージョン、
npm install -g pixverse、pixverse auth login、pixverse auth statusまで。 - 10〜20分: 文章を用意する。公式のひな形(被写体、場所、動き、カメラ、光、音、形式)を、1行ずつ埋めて、短い版を作る。
- 20〜25分: CLIなら
pixverse capabilities create video --model v6 --jsonで、選べる画質や長さを見る。 - 25〜35分: 最初の1本を作る。短く、小さい画質で試す(同じモデルでも解像度と長さと音声でクレジットが変わることは、04を参照。API向けの料金表の話で、Webの画面の数字は確認できていません)。
- 35〜45分: 結果を見て、直すのは1つだけにして、もう一度作る(原因を切り分けやすくするための、この記事の見立てです)。
- 45〜55分: 手元にある1枚の画像で、画像から動画を試す。入れる画像の権利を、04で読んだ範囲で確認しておく。
- 55〜60分: 作ったものの保存を確認する。CLIなら
pixverse asset download <id> --dest ./out/。Webの保存の仕方は、公式の資料では確認できていません。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。
- Webとアプリの作る画面の中身は読めていません。画面の名前、ボタン、設定項目は、公式の製品ページに出てくる範囲にとどめました。
- 「この記事の例」のプロンプトは、公式のひな形に合わせて組んだものです。生成結果は保証されません。
- CLIのオプションは版で変わります(変更履歴の最新は1.4.13、2026-10-23の表示)。
pixverse capabilities ...や--helpで、手元の版を確かめてください。 - 公式ページ同士で、CLIの書き方が食い違う点があります。03で読んだ公式トップページの例には
--ratioが出てきますが、今回読んだREADMEの一覧には--aspect-ratioがあり、--ratioは見つかりませんでした。この記事はREADMEの表記で書きました。どれが今の正しい書き方かは、手元の--helpで確認してください。 - 他人が写った画像、他人の作品を入れるときは、04で読んだ規約の記述を確認してください。
- 規約は変わります。この記事は法律の助言ではありません。
出典
- Text to Video(PixVerse、確認日 2026-10-25)
- Image to Video(PixVerse、確認日 2026-10-25)
- PixVerse V6(モデルページ、PixVerse、確認日 2026-10-25)
- Canvas(PixVerse、確認日 2026-10-25)
- App Download(PixVerse、確認日 2026-10-25)
- PixVerse CLI(PixVerse、確認日 2026-10-25)
- PixVerse CLI README(PixVerseAI/cli、GitHub、確認日 2026-10-25)
- PixVerse CLI Changelog(PixVerseAI/cli、GitHub、確認日 2026-10-25)
- pixverseai/skills(GitHub、確認日 2026-10-25)
- PixVerse CLI Skill(SKILL.md、pixverseai/skills、GitHub、確認日 2026-10-25)
- create-video(pixverseai/skills、GitHub、確認日 2026-10-25)
- PixVerse Plugin for ChatGPT(紹介ページ、PixVerse、確認日 2026-10-25)