動画エフェクトテンプレートは、動画生成エフェクトのプリセットです。初回フレーム画像とテンプレート値を指定することで、「魔法の浮遊」や「スクイーズ」といった特定の動的エフェクトを持つ動画を生成できます。この機能は、ソーシャルメディア、マーケティングプロモーション、インタラクティブエンターテインメントに適しています。
このドキュメントは、中国 (北京) リージョンにのみ適用されます。このモデルを使用するには、API キーを中国 (北京) リージョンから取得する必要があります。
入力初回フレーム画像
| 出力例 1：「魔法の浮遊」エフェクト | 出力例 2：「スクイーズ」エフェクト |
|---|---|
| demo_flying.mp4 | demo_squish.mp4 |
| テンプレート値：flying | テンプレート値：squish |
使用方法
範囲：動画エフェクトテンプレートは、Wan Image-to-Video (初回フレーム) タスクでのみサポートされています。
方法：リクエストボディで、
templateパラメーターを flying などの目的のテンプレート値に設定します。利用可能なすべてのテンプレートについては、「動画エフェクトテンプレート」をご参照ください。注意：
templateパラメーターを使用する場合、モデルはpromptフィールドを無視します。このフィールドは省略するか、空のままにすることができます。
リクエストの送信
Image-to-Video API は非同期ワークフローを使用します。動画生成タスクを送信した後、タスクのステータスをクエリして結果を取得します。タスクステータスのポーリングや生成された動画のダウンロード方法を含む完全なワークフローについては、「Image-to-Video API」リファレンスをご参照ください。
次の例は、動画エフェクトテンプレートを使用して動画生成リクエストを送信する方法を示しています。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wanx2.1-i2v-turbo",
"input": {
"img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png",
"template": "flying"
},
"parameters": {
"resolution": "720P"
}
}'動画エフェクトテンプレート
最適な結果を得るには、各テンプレートの「入力画像の推奨事項」列をご参照ください。
モデルサポートのまとめ
| モデル | サポートされているテンプレート |
|---|---|
| wanx2.1-i2v-plus | すべてのテンプレート |
| wanx2.1-i2v-turbo | 一般エフェクト、カルーセル、ラブユー、一人または動物用エフェクト、二人用エフェクト |
一般エフェクト
すべての一般エフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方をサポートしています。
これらのエフェクトは、任意のエンティティで機能します。最良の結果を得るには、エンティティが目立ち、バックグラウンドから明確に区別されているイメージを使用してください。
| エフェクト名 | テンプレート値 | エフェクト例 |
|---|---|---|
| スクイーズ | squish | squish.mp4 |
| スピン | rotation | rotation.mp4 |
| ポーク | poke | poke.mp4 |
| 風船膨張 | inflate | inflate.mp4 |
| 分子拡散 | dissolve | dissolve.mp4 |
一人用エフェクト
これらのエフェクトは、一人の写真で機能します。特に記載がない限り、半身から全身の正面写真が推奨されます。
| エフェクト名 | テンプレート値 | サポートされているモデル | 入力画像の推奨事項 | エフェクト例 |
|---|---|---|---|---|
| カルーセル | carousel | wanx2.1-i2v-plus, wanx2.1-i2v-turbo | - | carousel.mp4 |
| ラブユー | 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 |
一人または動物用エフェクト
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方をサポートしています。
これらのエフェクトは、一人または動物の写真で機能します。
| エフェクト名 | テンプレート値 | 入力画像の推奨事項 | エフェクト例 |
|---|---|---|---|
| 魔法の浮遊 | flying | 全身の正面写真を推奨 | flying.mp4 |
| あなたにバラを | rose | 半身から全身の正面写真を推奨。手が見えないようにしてください。 | rose.mp4 |
| 輝くバラ | crystalrose | 半身から全身の正面写真を推奨。手が見えないようにしてください。 | crystalrose.mp4 |
二人用エフェクト
このカテゴリのすべてのエフェクトは、wanx2.1-i2v-plus と wanx2.1-i2v-turbo の両方をサポートしています。
これらのエフェクトは、二人の写真で機能します。両方の人物がカメラの方を向いているか、お互いに向き合っている半身または全身の写真が推奨されます。
| エフェクト名 | テンプレート値 | エフェクト例 |
|---|---|---|
| 愛情のこもったハグ | hug | hug.mp4 |
| 相互依存 | frenchkiss | frenchkiss.mp4 |
| ダブルハートビート | coupleheart | coupleheart.mp4 |
参考資料
API パラメーターの説明と完全なコード例については、「Image-to-Video API」をご参照ください。