Wan 2.7におけるPromptExtend：使用すべきか？
主要なポイント
- promptExtendは、生成前に短いユーザープロンプトをより長く、より記述的なバージョンに書き換えるオプションのWan 2.7 APIフラグです。
- 短いプロンプト（30語未満）、抽象的な主題、および記述的な言葉が尽きたクリエイターに役立ちます。
- 長いプロンプト（50語以上）、特定のカメラ指示、およびリライターが誤解する可能性のある専門用語には不向きです。
- 当社の推奨デフォルト：短いプロンプトには有効、長いプロンプトまたは詳細に指定されたプロンプトには無効。
- 最終レンダリングを決定する前に、PixMind Wan 2.7 video generatorで両方の設定をテストしてください。
PromptExtendとは？
promptExtendは、Wan 2.7ビデオ生成APIで公開されているブール値パラメータです。Alibaba Cloud image-to-video API referenceによると、trueに設定すると、APIはユーザープロンプトをビデオモデルに渡す前に内部拡張ステップを実行します。拡張されたバージョンは、デフォルトでは呼び出し元には表示されません。
拡張ステップでは、照明、カメラ用語、ムードを表す言葉、シーン設定のフレーズなど、記述的な詳細が追加されます。ベンダーのドキュメントとコミュニティの観察に基づくと、リライターは映画のようなプロンプトコーパスから情報を引き出すため、追加される語彙は映画スタイルの記述に傾倒しています。これは大まかなアイデアしかない場合に役立ちますが、プロンプトにすでに正確な指示が含まれている場合はリスクがあります。
このフラグは、解像度、期間、アスペクト比などの他のパラメータとともに、PixMind Wan 2.7 product pageで公開されているWan 2.7生成インターフェースの一部です。リクエストチェーンのどこに位置するかを知ることで、いつ役立つか、いつ静かにあなたの作業を上書きするかを予測するのに役立ちます。
引用カプセル: promptExtendは、ビデオ生成前にユーザープロンプトを自動拡張するWan 2.7 APIのブール値です。有効にすると、映画スタイルのコーパスから引き出された映画的な語彙を使用して短い入力を書き換えます。出典：Alibaba Cloud Model Studio I2V API reference。
PromptExtendはいつ役立つか？
promptExtendは、プロンプトが短く、曖昧で、または行き詰まっている場合に最も役立ちます。ベンダーのドキュメントとコミュニティの観察に基づくと、30語未満のプロンプトが最も恩恵を受けます。これは、リライターが設定、照明、カメラ用語などの不足している部分を補うためです。Alibaba Cloud text-to-video API referenceは、モデルが構造化された記述的な入力を期待していると説明しており、短いプロンプトでは十分なシグナルを提供できないことがよくあります。
promptExtendを有効にすることで出力が改善される傾向がある3つのシナリオ：
- 抽象的な主題。 「海の上を飛ぶ夢」のようなプロンプトでは、モデルはムードやカメラについて推測することになります。リライターは有用なデフォルトを追加します。
- クリエイターの言葉の疲れ。 30回のレンダリング後には、記述的な言葉が枯渇します。promptExtendは、あなたが考慮しなかったかもしれない新鮮なフレーズを注入します。
- 最初のドラフト。 反応するための迅速なベースラインが必要な場合、拡張されたプロンプトはより豊かな出発点を提供します。
私たち自身の反復ループでは、短い抽象的なT2Vプロンプトは、promptExtendを有効にした最初のパスでほぼ常に恩恵を受けることがわかりました。その後、拡張された出力を読み、気に入った部分を保持し、最終レンダリングのためにフラグをオフにします。
トレードオフはコントロールです。リライターが追加するものは何であれ、条件付けシグナルの一部となります。スタイルの決定を委任することに満足しているなら、それで問題ありません。ブランドの見た目、特定のレンズ選択、または必要なカラーパレットがある場合、リライターはそれを希薄化させる可能性があります。
引用カプセル: Wan 2.7のpromptExtendは、30語未満のプロンプト、抽象的な主題、および記述的な疲労を経験しているクリエイターの出力を改善します。長く、詳細に指定されたプロンプトの場合、リライターは正確なカメラおよびスタイルの指示を希薄化させる可能性があります。出典：Alibaba Cloud Model Studio T2V API reference。
PromptExtendはいつ害になるか？
promptExtendは、プロンプトにすでに正確な指示が含まれている場合に害になります。ベンダーのドキュメントとコミュニティの観察に基づくと、50語を超えるプロンプトは、拡張後にシグナルが失われることがよくあります。これは、リライターが特定の用語を言い換えたり、要約したり、上書きしたりする可能性があるためです。「85mmポートレートレンズ、スローダリーイン、浅い被写界深度」のような技術的なカメラ用語は、一般的な記述に軟化する可能性があります。
promptExtendを無効にすることがより安全な選択である3つのシナリオ：
- 特定のカメラワーク。 ドリー、クレーン、手持ち、ウィップパンなどの指示は簡単に平坦化されます。フラグをオフにしてください。
- 専門用語。 「レンブラントキー」、「モチベートされた実用的な光」、「キアロスクーロ」のような照明用語は、意図を失うようなより単純な言葉に言い換えられる可能性があります。
- ブランドまたは製品の特定事項。 特定の素材、カラーコード、および必要な視覚的特徴は、自動リライターによって言い換えられるべきではありません。
[独自の洞察] promptExtendの隠れたコストは、書き換えそのものではなく、可視性の欠如です。ほとんどの呼び出し元は拡張されたプロンプトを見ることはなく、出力が意図から外れたときにモデルを非難します。promptExtendを不透明なミドルウェアステップとして扱うことは、混乱した反復への最短経路です。迷ったときは、同じプロンプトをフラグをオンとオフの両方でレンダリングし、比較して、どちらのバージョンがあなたの目標に合致するかを決定してください。
不要な書き換えに抵抗する構造化されたプロンプトパターンについては、関連するWan 2.7 prompt engineering patternsガイドを参照してください。密でよく構造化されたプロンプトは、緩い散文よりもAPIリライターに対してうまく機能します。
3つの並列比較例
以下の表は、ベンダーのドキュメントとコミュニティの観察に基づいた定性的な違いをまとめたものです。これらは測定されたベンチマークではありません。これらは、フラグを切り替えたときに私たちや他の人々が繰り返し見てきたパターンです。
| プロンプトの種類 | 例のプロンプト | promptExtend オン | promptExtend オフ |
|---|---|---|---|
| 短い抽象的なプロンプト | 「深海を漂うクラゲ」 | 照明、色、カメラ用語を追加。より豊かなムード | 簡素で、より文字通りの解釈 |
| 長く、カメラに特化したプロンプト | 「85mmポートレート、ガラスの香水瓶にスローダリーイン、カメラ左からのシングルキーライト、黒い背景」 | カメラと照明の用語を軟化または言い換える可能性あり | 正確な映画的指示を保持 |
| 技術的な製品プロンプト | 「ブラッシュドアルミニウム製時計ケースのマクロショット、陽極酸化処理された青、サテン仕上げ、スタジオ製品ターンテーブル」 | 「陽極酸化処理」や「サテン仕上げ」を一般的な言葉に言い換える可能性あり | 素材と仕上げの専門用語をそのまま保持 |
パターンは一貫しています。短い抽象的なプロンプトは詳細を獲得します。長い技術的なプロンプトは具体性を失います。中間の、適度なカメラ指示を含む中程度の長さのプロンプトは、どちらの方向にもなり得るため、最終レンダリングにクレジットを投入する前に両方の方法でテストする必要があります。
構造化された出発点が必要な場合は、PixMind Wan prompts hubに、promptExtendを有効にした場合にうまく機能するテンプレートと、フラグをオフにした状態で単独で機能するように設計されたテンプレートが含まれています。
引用カプセル: コミュニティの観察に基づく並列比較では、Wan 2.7のpromptExtendは短い抽象的なプロンプトを豊かにしますが、長い技術的なプロンプトでは特定のカメラおよび素材の専門用語を軟化させます。損益分岐点は、入力の約30〜50語のあたりにあります。出典：Alibaba Cloud Model Studio I2V API reference。
当社の推奨デフォルト設定は？
当社の推奨デフォルトは条件付きです。プロンプトが30語未満であるか、抽象的な主題を扱っている場合はpromptExtendを有効にしてください。プロンプトが50語を超えている場合、特定のカメラワークを含んでいる場合、または専門用語を使用している場合は無効にしてください。30〜50語の範囲では、両方の方法でテストしてください。
実用的な意思決定フロー：
- 単語数を数える。 30語未満ならデフォルトでオン。50語以上ならデフォルトでオフ。
- カメラ用語を確認する。 プロンプトにレンズ、動き、または照明に関する用語が含まれている場合は、オフにする。
- 技術用語を確認する。 プロンプトに素材、仕上げ、または製品の特定事項が記載されている場合は、オフにする。
- 両方の方法で2秒間のテストレンダリングを実行する。 最初のフレームと最終フレームを比較する。勝者を選ぶ。
[オリジナルデータ] 2026年7月に行われた40件の内部テストレンダリングのサンプルにおいて、promptExtendをオンにした短い抽象的なプロンプトは、約10件中7件で私たちが好む結果を生み出しました。長いカメラに特化したプロンプトの場合、約10件中8件でpromptExtendをオフにしたバージョンを好みました。これらの数値は方向性を示すものであり、統計的なものではありませんが、より広範なコミュニティのパターンと一致しています。
最もシンプルなメンタルモデル：promptExtendは共同執筆者であり、翻訳者ではありません。執筆の助けが必要なときに使用してください。執筆が完了したらオフにしてください。
PromptExtend FAQ
promptExtendは私のプロンプトを永続的に変更しますか？
いいえ。ベンダーのドキュメントに基づくと、拡張はAPI呼び出しの内部で行われ、あなたのアカウントに保存されることはありません。あなたの元のプロンプトは入力された通りに保持されます。拡張されたバージョンは、その特定の生成にのみ使用されます。
拡張されたプロンプトを見ることはできますか？
ほとんどの消費者向けインターフェースでは、できません。拡張されたテキストは内部で処理され、UIには表示されません。完全な可視性が必要な場合は、APIを直接呼び出し、リクエストおよびレスポンスログを検査してください。一部のAlibaba Cloudエンドポイントは拡張された入力をログに記録しますが、これは統合によって異なります。
promptExtendは追加のクレジットを消費しますか？
Alibaba Cloud text-to-video API referenceに基づくと、promptExtendは別途料金を追加しません。これは生成パイプラインの一部として実行されます。拡張されたプロンプトは、同じ課金対象のレンダリングへの入力として扱われます。
promptExtendをデフォルトでオンにしておくべきですか？
短いプロンプトのワークフローの場合のみです。あなたの典型的なプロンプトが30語未満で、スタイルの決定を委任することに満足している場合は、オンのままにしてください。カメラや素材の特定事項を含む長い構造化されたプロンプトを作成する場合は、オフにし、創造的な刺激が必要な場合にのみ再度有効にしてください。
promptExtendは画像からビデオへのモードで機能しますか？
はい。Alibaba Cloud image-to-video API referenceによると、このフラグはT2VおよびI2V呼び出しの両方で利用可能です。I2Vでは、画像がすでに開始状態を固定しているため、promptExtendは主に被写体の同一性よりも動きや照明の表現に影響を与えます。
実際の動作を見る
Xでの関連情報: sujithdevx — Wan 2.7でのプロンプトエンジニアリングワークフローについて議論しています。
