Wan 2.7 APIガイド：テキストから動画、画像から動画、リファレンス動画、動画編集 — 完全統合ハンドブック

要約

• Wan 2.7は1つのエンドポイントに4つのモデル。 テキストから動画、画像から動画（先頭/末尾フレーム制御付き）、マルチキャラクターリファレンス動画（ボイスクローニング付き）、指示ベースの動画編集 — すべてPOST /v1/videos/generationsで利用可能。
• EvoLinkの料金： 720pで$0.086/秒、1080pで$0.144/秒。10秒の720pクリップのコストは$0.86。サブスクリプションなし。
• モデルID： wan2.7-text-to-video、wan2.7-image-to-video、wan2.7-reference-video、wan2.7-video-edit。
• 非同期ワークフロー。 すべてのリクエストは即座にタスクIDを返します。GET /v1/tasks/\{task_id\}でステータスをポーリング。動画URLは24時間で期限切れ。
• EvoLinkでWan 2.7がWan 2.6に追加するもの： Wan 2.7ルートによる動画編集、I2Vでの先頭・末尾フレーム制御、ボイスクローニング付きマルチキャラクターリファレンス動画。
• 失敗したタスクは課金されません — リファレンス動画モードと動画編集モードの場合。

目次

1. クイックスタート：60秒で最初のWan 2.7動画を生成
2. 適切なモデルIDを選択
3. モード1：テキストから動画
4. モード2：フレーム制御付き画像から動画
5. モード3：ボイスクローニング付きリファレンス動画
6. モード4：動画編集
7. 料金とコスト計算
8. 非同期ワークフローとタスク管理
9. エラーハンドリングと一般的なステータスコード
10. 本番パターンとガードレール
11. Wan 2.6からWan 2.7への移行
12. パラメータリファレンスチートシート
13. よくある質問

1. クイックスタート：60秒で最初のWan 2.7動画を生成

ステップ1：動画を生成

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-text-to-video",
    "prompt": "A drone shot over a misty mountain lake at sunrise, slow camera push forward, cinematic color grading",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "id": "task-unified-1757169743-7cvnl5zw",
  "status": "pending",
  "created": 1757169743
}

ステップ2：結果をポーリング

curl https://api.evolink.ai/v1/tasks/task-unified-1757169743-7cvnl5zw \
  -H "Authorization: Bearer YOUR_API_KEY"

ステップ3：以上です

2. 適切なモデルIDを選択

3. モード1：テキストから動画

機能

テキストプロンプトから動画を生成します。リップシンクや音楽同期出力用のオプションのドライビングオーディオをサポート。オーディオが提供されない場合、自動的にBGMを生成します。

主要パラメータ

マルチショットナラティブ

プロンプト内で直接ショット構造を制御：

{
  "model": "wan2.7-text-to-video",
  "prompt": "A tense detective story. Shot 1 [0-3s] wide angle: rainy night street, neon lights. Shot 2 [3-6s] medium: detective enters old building. Shot 3 [6-9s] close-up: detective's determined eyes. Shot 4 [9-12s] medium: cautious advance through dim corridor. Shot 5 [12-15s] close-up: discovers key clue.",
  "aspect_ratio": "16:9",
  "duration": 15
}

ドライビングオーディオ付き

{
  "model": "wan2.7-text-to-video",
  "prompt": "A cartoon general in golden armor on a horse, reciting a classical poem",
  "audio_urls": ["https://your-cdn.com/recital.mp3"],
  "duration": 10
}

4. モード2：フレーム制御付き画像から動画

機能

3つの生成モード

有効な入力の組み合わせ

1. image_startのみ
2. image_start + audio_urls
3. image_start + image_end
4. image_start + image_end + audio_urls
5. video_urls（継続）
6. video_urls + image_end（終了フレーム付き継続）

その他の組み合わせは拒否されます。

例：先頭・末尾フレーム

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-to-video",
    "generation_mode": "first_last_frame",
    "prompt": "A product bottle rotating 360 degrees with soft studio lighting",
    "image_start": "https://your-cdn.com/bottle-front.jpg",
    "image_end": "https://your-cdn.com/bottle-back.jpg",
    "quality": "1080p",
    "duration": 5
  }'

例：動画の継続

{
  "model": "wan2.7-image-to-video",
  "generation_mode": "video_continuation",
  "prompt": "The scene continues with the character walking toward the sunset",
  "video_urls": ["https://your-cdn.com/previous-clip.mp4"],
  "image_end": "https://your-cdn.com/sunset-ending.jpg",
  "duration": 5
}

5. モード3：ボイスクローニング付きリファレンス動画

機能

リファレンス画像や動画からキャラクターの外見を保持しながら新しい動画シーンを生成 — オプションで短いオーディオサンプルからボイスクローニングも可能です。これにより、各人物がエピソード間で一貫した見た目と声を持つマルチキャラクター動画シリーズを構築できます。

主な制約

• image_urls + video_urlsの合計：最大5アイテム
• image_startとボイスオーディオはこの5アイテム制限にカウントされません
• 時間：2-15秒（画像のみのリファレンス）、2-10秒（動画リファレンスを含む場合）
• 課金：入力動画の時間 + 出力動画の時間。失敗したタスクは無料。

プロンプト内のキャラクターインデックス

入力配列内の位置でキャラクターを参照：

• 英語：Image 1、Image 2、Video 1、Video 2
• 中国語：图1、图2、视频1、视频2

ボイスクローニング：2つの方法

キャラクターリファレンスとボイスオーディオの正確なキーバリューマッピング：

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 holds Image 2 and says: 'What lovely sunshine today'",
  "image_urls": [
    "https://your-cdn.com/girl.jpg",
    "https://your-cdn.com/toy.png"
  ],
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/girl-voice.mp3"
    }
  },
  "duration": 10
}

例：マルチキャラクターブランド動画

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 and Image 2 are having a conversation in a modern office. Image 1 explains the product while Image 2 takes notes. The scene is professional and well-lit.",
  "image_urls": [
    "https://your-cdn.com/spokesperson-a.jpg",
    "https://your-cdn.com/spokesperson-b.jpg"
  ],
  "image_start": "https://your-cdn.com/office-wide-shot.jpg",
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/voice-a.mp3",
      "image2": "https://your-cdn.com/voice-b.mp3"
    }
  },
  "quality": "1080p",
  "duration": 10
}

マルチグリッドストーリーボード

複数パネルを持つ単一画像リファレンス（例：キャラクターポーズの3×3グリッド）の場合：

{
  "model": "wan2.7-reference-video",
  "prompt": "Reference image. 3D cartoon style. 1. Wide shot of fantasy forest. 2. Boy parts the vines. 3. Robot scans ahead. 4. Close-up of map. 5. Boy's excited face. 6. They leap over roots.",
  "image_urls": ["https://your-cdn.com/storyboard-grid.png"],
  "duration": 15
}

6. モード4：動画編集

機能

主要パラメータ

例：指示のみのスタイル変更

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video-edit",
    "prompt": "Convert the entire scene to a vintage film look with warm color grading and film grain",
    "video_urls": ["https://your-cdn.com/source-clip.mp4"],
    "keep_original_sound": true,
    "duration": 0
  }'

例：リファレンスガイド付き衣装変更

{
  "model": "wan2.7-video-edit",
  "prompt": "Replace the girl's outfit with the clothes from the reference image",
  "video_urls": ["https://your-cdn.com/source.mp4"],
  "image_urls": ["https://your-cdn.com/target-outfit.png"]
}

編集できること

• スタイル変換： 「アニメスタイルに変換」「水彩画エフェクトを適用」
• 背景変更： 「背景を夜の雨に濡れた東京の通りに変更」
• オブジェクト/衣装変更： 「ジャケットを赤に変更」「帽子を王冠に置き換え」
• カラー化： 「この白黒映像をカラーに変換」
• ライティング： 「ゴールデンアワーのライティングに変更」

7. 料金とコスト計算

EvoLink Wan 2.7料金

サブスクリプションなし、最低契約なし。正常に生成された動画に対してのみ課金されます。

他プロバイダーとのコスト比較（プロバイダーページの掲載情報、2026年5月時点）

リファレンス動画と動画編集の特別課金

予算見積もり式

8. 非同期ワークフローとタスク管理

すべてのWan 2.7リクエストは同じ非同期パターンに従います：

タスクのライフサイクル

コールバックURL（webhook）

本番のベストプラクティス

1. タスクIDを送信後すぐに永続化。 サービスがクラッシュしても復旧できます。
2. ポーリング時に指数バックオフを使用。 5秒から開始し、最大30秒まで。
3. 結果をすぐにダウンロードしてアーカイブ。 動画URLは24時間で期限切れ。
4. 送信をべき等にする。 リクエストペイロードをハッシュし、重複排除してリトライストームによる二重課金を防止。

9. エラーハンドリングと一般的なステータスコード

よくあるミス

• モデルIDのスペルミス。 wan2.7-text-to-videoであり、wan-2.7-text-to-videoやwan27-t2vではありません。古いモデルIDは有用なエラーなしでクリーンな404を返します。
• I2Vモードで無効なメディアの組み合わせを送信。 有効な入力の組み合わせ表を確認してください。
• 結果を時間内にダウンロードしない。 動画URLは24時間で期限切れ。パイプラインに自動ダウンロードを組み込んでください。

10. 本番パターンとガードレール

予算ガードレール

信頼性パターン

• べき等キーでリトライ。 リクエストペイロードをハッシュし、再送信前に既存タスクを確認。
• タイムアウトハンドリング。 タスクが5分後に完了していない場合、盲目的に再送信するのではなく手動レビュー用にマーク。
• フォールバック戦略。 Wan 2.7が特定モードで永続的なエラーを返す場合、Wan 2.6またはWan 2.5へのフォールバックを検討。
• アセット検証。 送信前に画像の寸法、動画の時間、オーディオ形式を検証。不良アセットはモデル品質の問題に見える失敗を引き起こします。

キューアーキテクチャ

1日100本以上の動画を生成する本番システム向け：

ユーザー向けリクエストハンドラーからAPIを直接呼び出さないでください。常にバックグラウンドジョブシステムを経由してください。

11. Wan 2.6からWan 2.7への移行

変わらないもの

• APIエンドポイント：POST /v1/videos/generations
• 認証：同じAPIキーとBearerトークン
• 非同期パターン：同じタスクID / ポーリング / コールバックフロー
• EvoLinkの課金：同じアカウントとクレジットシステム

変わるもの

ステップバイステップの移行

1. modelパラメータを変更。 wan2.6-text-to-videoをwan2.7-text-to-videoに置換（他のモードも同様）。
2. 既存のプロンプトでテスト。 Wan 2.7は同じプロンプト形式を処理します。書き換え不要。
3. 新機能を段階的に採用。 ワークフローの要件に応じてgeneration_mode、image_end、voice_bindings、動画編集を追加。
4. Wan 2.6をフォールバックとして維持。 両バージョンはEvoLinkで並行稼働。すべてを一度に移行する必要はありません。

12. パラメータリファレンスチートシート

共有パラメータ（全モード）

テキストから動画固有

画像から動画固有

リファレンス動画固有

動画編集固有

13. よくある質問

EvoLinkでのWan 2.7の料金は？

720pで$0.086/秒、1080pで$0.144/秒。10秒の720pクリップのコストは$0.86。サブスクリプションや最低契約なし。

Wan 2.7とWan 2.6の違いは？

EvoLinkでは、Wan 2.7は動画編集、ボイスクローニング付きマルチキャラクターリファレンス動画、I2Vモードでの先頭・末尾フレーム制御を提供します。Wan 2.6はシネマティックストーリーテリングやFlashバリアントによる高速イテレーションに引き続き有用です。両方がEvoLinkで並行稼働しています。

Wan 2.7は自動的にオーディオを生成しますか？

失敗したタスクは課金されますか？

リファレンス動画と動画編集モードでは、失敗したタスクは明示的に課金されません。テキストから動画と画像から動画では、実際に生成された動画の時間に基づいて課金されます。

Wan 2.7をNSFWコンテンツに使用できますか？

ボイスクローニングでサポートされるオーディオ形式は？

動画URLの期限切れにどう対処しますか？

動画URLは24時間後に期限切れになります。タスク完了後すぐにパイプラインに自動ダウンロードとアーカイブのステップを組み込んでください。最終アセットは自社のCDNまたはオブジェクトストレージに保存してください。

Wan 2.6からダウンタイムなしで移行できますか？

次のステップ

• プレイグラウンドを試す： Wan 2.7モデルページ
• Wanモデルを比較： Wan APIファミリーコレクション
• 料金の完全な内訳： Wan API料金ガイド
• Wan 2.6の本番パターン： Wan 2.6 APIガイド
• Wan 2.5レビュー： Wan 2.5 APIレビュー