Wan 動画生成
AceDataCloud の Wan(Alibaba)API を通じて AI 動画を生成します。
セットアップ: トークン設定については認証を参照してください。
クイックスタート
curl -X POST https://api.acedata.cloud/wan/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "wan2.6-t2v"}'
非同期: 非同期タスクのポーリングを参照してください。
POST /wan/tasksで{"id": "..."}を指定してポーリングします。
モデル
| モデル | 種類 | 最適な用途 |
|---|---|---|
wan2.6-t2v | テキスト→動画 | テキスト説明から動画を作成 |
wan2.6-i2v | 画像→動画 | 静止画像を動画にアニメーション化 |
wan2.6-r2v | 参照動画→動画 | 参照動画からキャラクター抽出と転送 |
wan2.6-i2v-flash | 画像→動画(高速) | 高速な画像→動画生成 |
ワークフロー
1. テキスト→動画
POST /wan/videos
{
"action": "text2video",
"prompt": "a time-lapse of flowers blooming in a meadow",
"model": "wan2.6-t2v",
"resolution": "720P",
"duration": 5
}
2. 画像→動画
静止画像を動画クリップにアニメーション化します。
POST /wan/videos
{
"action": "image2video",
"prompt": "gentle wind blows through the scene",
"model": "wan2.6-i2v",
"image_url": "https://example.com/landscape.jpg",
"resolution": "720P",
"duration": 5
}
3. 画像→動画(Flash)
レイテンシを低減した高速な画像→動画生成。
POST /wan/videos
{
"action": "image2video",
"prompt": "camera slowly pans across the landscape",
"model": "wan2.6-i2v-flash",
"image_url": "https://example.com/scene.jpg"
}
4. 参照動画転送
参照動画からキャラクターや声色を抽出し、新しい生成に転送します。
POST /wan/videos
{
"action": "text2video",
"prompt": "the character walks through a futuristic city at night",
"model": "wan2.6-r2v",
"reference_video_urls": ["https://example.com/reference.mp4"]
}
5. マルチカット編集
単一の連続テイクではなく、複数のショットで構成される動画を生成します。
POST /wan/videos
{
"action": "text2video",
"prompt": "a chef preparing a meal in a busy kitchen",
"model": "wan2.6-t2v",
"shot_type": "multi",
"duration": 10
}
6. 音声付き動画
動画と共に音声を生成します。
POST /wan/videos
{
"action": "text2video",
"prompt": "ocean waves crashing on a rocky shore",
"model": "wan2.6-t2v",
"audio": true
}
パラメータ
| パラメータ | 必須 | 値 | 説明 |
|---|---|---|---|
action | はい | "text2video", "image2video" | アクションタイプ |
prompt | はい | 文字列 | シーン説明 |
model | はい | "wan2.6-t2v", "wan2.6-i2v", "wan2.6-r2v", "wan2.6-i2v-flash" | モデル |
image_url | image2video の場合 | 文字列 | ソース画像 URL(画像→動画では必須) |
negative_prompt | いいえ | 文字列(最大500文字) | 生成から除外する内容 |
reference_video_urls | r2v の場合 | 文字列の配列 | キャラクター/声色抽出の参照動画 |
shot_type | いいえ | "single", "multi" | 連続ショットまたはマルチカット編集 |
audio | いいえ | 真偽値 | 生成動画に音声を有効にする |
audio_url | いいえ | 文字列 | 参照音声 URL |
resolution | いいえ | "480P", "720P", "1080P" | 出力解像度(デフォルト: 720P) |
size | いいえ | 文字列 | 生成動画のサイズ |
duration | いいえ | 5, 10, 15 | 動画の長さ(秒) |
prompt_extend | いいえ | 真偽値 | LLM ベースのプロンプト書き換えを有効にする |
callback_url | いいえ | 文字列 | 非同期 Webhook 通知 URL |
注意点
image_urlはwan2.6-i2vおよびwan2.6-i2v-flashモデルで必須ですreference_video_urlsはキャラクター/声色転送のためのwan2.6-r2vでのみ使用しますnegative_promptは最大500文字です- 対応する動画の長さは 5、10、または 15 秒のみです
- デフォルトの解像度は 720P です。高品質が必要な場合は 1080P を使用しますが、コストが増加します
shot_type: "multi"は単一の連続ショットではなくマルチカット編集を生成します
MCP:
pip install mcp-wan| ホスト版:https://wan.mcp.acedata.cloud/mcp| すべての MCP サーバーを参照