動画エフェクトテンプレートは、動画生成エフェクトのプリセットです。 開始フレーム画像 と テンプレート値 を指定することで、「魔法の浮遊」や「スクイーズ」などの特定の動的エフェクトを持つ動画を生成できます。この機能は、ソーシャルメディア、マーケティングプロモーション、インタラクティブエンターテイメントに適しています。
入力する開始フレーム画像
Image-to-Video API は非同期ワークフローを使用します。動画生成タスクを送信した後、タスクのステータスをクエリして結果を取得します。タスクのステータスのポーリング方法や生成された動画のダウンロード方法など、完全なワークフローについては、Image-to-Video API リファレンスをご参照ください。
次の例は、動画エフェクトテンプレートを使用して動画生成リクエストを送信する方法を示します。
最適な結果を得るには、各テンプレートの「入力画像の推奨事項」列をご参照ください。
すべての汎用エフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、あらゆる被写体で機能します。最適な結果を得るには、被写体が際立ち、背景から明確に区別されている画像を使用することを推奨します。
これらのエフェクトは、1 人が写っている写真で機能します。特に記載がない限り、半身から全身の正面写真を推奨します。
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、1 人または動物が写っている写真で機能します。
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、2 人が写っている写真で機能します。両者がカメラの方を向いている、または向かい合っている半身または全身の写真を推奨します。
| 出力例 1：「魔法の浮遊」エフェクト | 出力例 2：「スクイーズ」エフェクト |
|---|---|
| demo_flying.mp4 | demo_squish.mp4 |
| テンプレート値： flying | テンプレート値： squish |
使用方法
- 適用範囲：動画エフェクトテンプレートは、Wanxiang Image-to-Video (開始フレーム) タスクでのみ使用できます。
- 方法：リクエストボディで、
templateパラメーターを flying などの目的のテンプレート値に設定します。利用可能なすべてのテンプレートについては、動画エフェクトテンプレートをご参照ください。 - 注:
templateパラメーターを使用する場合、モデルはpromptフィールドを無視します。このフィールドは省略するか、空にすることができます。
リクエストの送信
Image-to-Video API は非同期ワークフローを使用します。動画生成タスクを送信した後、タスクのステータスをクエリして結果を取得します。タスクのステータスのポーリング方法や生成された動画のダウンロード方法など、完全なワークフローについては、Image-to-Video API リファレンスをご参照ください。
次の例は、動画エフェクトテンプレートを使用して動画生成リクエストを送信する方法を示します。
動画エフェクトテンプレート
最適な結果を得るには、各テンプレートの「入力画像の推奨事項」列をご参照ください。
モデルごとの対応状況
| モデル | 対応テンプレート |
|---|---|
| wanx2.1-i2v-plus | すべてのテンプレート |
| wanx2.1-i2v-turbo | 汎用エフェクト、カルーセル、Love You、1 人または動物のエフェクト、2 人用のエフェクト |
汎用エフェクト
すべての汎用エフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、あらゆる被写体で機能します。最適な結果を得るには、被写体が際立ち、背景から明確に区別されている画像を使用することを推奨します。
| エフェクト名 | テンプレート値 | エフェクト例 |
|---|---|---|
| スクイーズ | squish | squish.mp4 |
| スピン | rotation | rotation.mp4 |
| ポーク | poke | poke.mp4 |
| バルーン膨張 | inflate | inflate.mp4 |
| 分子拡散 | dissolve | dissolve.mp4 |
1 人用のエフェクト
これらのエフェクトは、1 人が写っている写真で機能します。特に記載がない限り、半身から全身の正面写真を推奨します。
| エフェクト名 | テンプレート値 | 対応モデル | 入力画像の推奨事項 | エフェクト例 |
|---|---|---|---|---|
| カルーセル | carousel | wanx2.1-i2v-plus、wanx2.1-i2v-turbo | - | carousel.mp4 |
| Love You | singleheart | wanx2.1-i2v-plus、wanx2.1-i2v-turbo | - | singleheart.mp4 |
| スイングタイム | dance1 | wanx2.1-i2v-plus | - | dance1.mp4 |
| スイングダンス | dance2 | wanx2.1-i2v-plus | 全身の正面写真を推奨 | dance2.mp4 |
| スタースイング | dance3 | wanx2.1-i2v-plus | 全身の正面写真を推奨 | dance3.mp4 |
| 人魚の目覚め | mermaid | wanx2.1-i2v-plus | 半身の正面写真を推奨 | mermaid.mp4 |
| 卒業戴帽 | graduation | wanx2.1-i2v-plus | - | graduation.mp4 |
| ドラゴンの追跡 | dragon | wanx2.1-i2v-plus | - | dragon.mp4 |
| 天からのお金 | money | wanx2.1-i2v-plus | - | money.mp4 |
1 人または動物のエフェクト
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、1 人または動物が写っている写真で機能します。
| エフェクト名 | テンプレート値 | 入力画像の推奨事項 | エフェクト例 |
|---|---|---|---|
| 魔法の浮遊 | flying | 全身の正面写真を推奨 | flying.mp4 |
| あなたへの薔薇 | rose | 半身から全身の正面写真を推奨します。手が写らないようにしてください。 | rose.mp4 |
| 輝く薔薇 | crystalrose | 半身から全身の正面写真を推奨します。手が写らないようにしてください。 | crystalrose.mp4 |
2 人用のエフェクト
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方に対応しています。
これらのエフェクトは、2 人が写っている写真で機能します。両者がカメラの方を向いている、または向かい合っている半身または全身の写真を推奨します。
| エフェクト名 | テンプレート値 | エフェクト例 |
|---|---|---|
| 愛のハグ | hug | hug.mp4 |
| 寄り添い | frenchkiss | frenchkiss.mp4 |
| 二人の鼓動 | coupleheart | coupleheart.mp4 |
関連ドキュメント
- API パラメーターの説明と完全なコード例については、Image-to-Video API をご参照ください。