wan-video

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"}'

非同期： 非同期タスクのポーリングを参照してください。{"id": "..."} を指定して POST /wan/tasks でポーリングします。

モデル

モデル	タイプ	最適な用途
wan2.6-t2v	テキストから動画	テキストによる説明から動画を作成
wan2.6-i2v	画像から動画	静止画像を動画にアニメーション化
wan2.6-r2v	参照動画から動画	参照動画からキャラクターを抽出して転送
wan2.6-i2v-flash	画像から動画（高速）	画像から動画をすばやく生成
wan3.0-video	オールインワン	テキスト、フレーム、参照メディア、ファイル、公開リンク

ワークフロー

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

注意事項

• wan2.6-i2v および wan2.6-i2v-flash モデルでは image_url が必須です
• 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 サーバーを参照

Wan 3 オールインワン

wan3.0-video は media からワークフローを推測します。対応するタイプは first_frame、last_frame、reference_image（最大 10 個）、reference_video（最大 5 個、合計 15 秒）、reference_audio（最大 5 個、合計 15 秒）、file、link です。フレームモードと参照／ファイル／リンクモードは併用できません。

POST /wan/videos
{
  "model": "wan3.0-video",
  "prompt": "Use image 1 to create a cinematic product video",
  "media": [{"type":"reference_image","url":"https://cdn.acedata.cloud/r9vsv9.png"}],
  "resolution": "720P",
  "ratio": "16:9",
  "duration": 5,
  "audio": true,
  "async": true
}

Wan 3 は 2～30 秒、または自動長さの -1 に対応しています。既存の /wan/tasks エンドポイントでポーリングしてください。