Quick Answer
Wan 2.7 は、テキストからの動画生成(text-to-video)、画像からの動画生成(image-to-video)、リファレンス誘導生成および編集ワークフローに対応する Alibaba のマルチモーダル動画生成スイートです。Wan 2.7 on CometAPI を通じて、開発者はモデル ID wan2.7 を非同期の POST /v1/videos エンドポイントで使用します。統合は3つの運用段階で構成されます:タスクを送信し、返却された動画 ID をポーリングし、完了した MP4 をダウンロードします。ライブルートは 720p と 1080p をサポートし、秒単価を提示するため、生成コストの見積は長さと解像度によって決まります。まずは 5 秒の 720p テキスト→動画リクエストから開始し、ワークフローを検証してから、基本ルートが機能するのを確認した上でイメージリファレンスや高解像度を追加してください。
Important scope: 本ガイドは CometAPI を通じた Wan 2.7 Video を対象とします。別の Wan 画像生成モデルは説明対象外であり、例えば 4K 静止画像出力のような画像専用仕様は Wan 2.7 Video の機能として扱いません。
Key Takeaways
- CometAPI は Wan 2.7 を、同期チャット応答ではなく、OpenAI スタイルの非同期動画エンドポイントとして公開します。
- ルートは model ID wan2.7 と POST /v1/videos を使用します。
- 完全な統合では、返却された動画 ID の保持、ステータスエンドポイントのポーリング、終端失敗の処理、成功後のみ MP4 のダウンロードを実装する必要があります。
- Alibaba のネイティブ Wan 2.7 テキスト→動画 API は 720P と 1080P、長さ 2–15 秒 をサポートします。CometAPI のルートは独自の統一フィールド名を使用します。
- 画像→動画、最初/最後フレーム、継続ワークフローは Alibaba のネイティブモデルファミリーに存在しますが、統一ルートで提供される高度なフィールドは、ライブドキュメントで必ず検証してください。
- 公開ベンチマークで最も強い証拠は動画→動画です:Wan 2.7 は Design Arena カテゴリでトップでした。その結果を全てのテキスト→動画や画像→動画タスクへ一般化すべきではありません。
- 最も有用な本番指標は、生成秒単価そのものではなく、承認されたクリップあたりのコストです。
What Is Wan 2.7?
Wan 2.7 in Plain Developer Terms
Wan 2.7 は単なるプロンプト→動画のチェックポイントではありません。Alibaba は Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v, Wan2.7-videoedit から成る4部構成の動画ファミリーだと説明しています。これらのバリアントは、テキストからの生成、画像からのアニメーション、被写体やスタイルのリファレンス誘導制御、既存動画の変換をカバーします。これはアプリケーション設計にとって重要です:簡単なマーケティングクリップはテキスト→動画だけで済むかもしれませんが、キャラクター一貫性が必要なプロダクションパイプラインでは、リファレンス入力、アンカーとなるフレーム、オーディオガイダンス、反復編集が必要になる場合があります。
CometAPI 上では、ルートがプロバイダ固有の名称を意図的に圧縮し、顧客向けのモデル ID を wan2.7 に統一しています。基盤の生成能力は Wan 2.7 のままですが、認証、エンドポイントパス、パラメータ名は Alibaba Cloud のネイティブ API とは異なります。
Wan 2.7 Technical Specifications
| Specification | Wan 2.7 Video |
|---|---|
| Provider | Alibaba / Wan |
| CometAPI model ID | wan2.7 |
| Native text-to-video IDs | wan2.7-t2v, wan2.7-t2v-2026-06-12 |
| Native image-to-video ID | wan2.7-i2v-2026-04-25 |
| Main inputs | テキスト;サポートされるワークフローでは画像、音声、動画 |
| Main output | サポートされる音声動作を伴う生成動画 |
| Modes | T2V, I2V, R2V, 動画編集、最初/最後フレーム、継続 |
| Resolution | 720P と 1080P |
| T2V duration | 2–15 秒;デフォルトは 5 秒 |
| T2V aspect ratios | 16:9, 9:16, 1:1, 4:3, 3:4 |
| Prompt limit | ネイティブ Wan 2.7 T2V では 5,000 文字 |
| Negative prompt limit | 500 文字 |
| Audio formats and limits | WAV/MP3;2–30 秒;最大 15 MB |
| Invocation | 非同期 |
| Architecture / parameter count | 公式 API ドキュメントに包括的な公開はなし |
Specification boundary: 一部のカタログページはアーキテクチャやパラメータ数を記述しますが、Alibaba の公式動画 API ドキュメントは Wan 2.7 の全バリアントについて完全なアーキテクチャ仕様を公開していません。より安全な編集表現として、完全なパラメータ数とアーキテクチャは網羅的には開示されていないと述べるべきです。
What Can Wan 2.7 Do?
Text-to-video with timed multi-shot prompts.
Wan 2.7 はプロンプト内に直接書かれたショット変更を解釈できます。開発者はショット 1、ショット 2、ショット 3 を、別のショット制御フィールドに頼るのではなく、時間範囲で記述できます。これによりプロンプト自体がコンパクトな絵コンテになります。
First- and last-frame control.
ネイティブの画像→動画ワークフローは、最初フレームや最後フレームのメディアを受け入れ、2つの視覚アンカー間の動きをモデルが合成できるようにします。これは製品トランジション、ポーズ変更、シーンモーフィングに有用です。
Video continuation.
ネイティブ入力の first_clip タイプは、動画の次の部分を条件付けします。このワークフローでは、長さはプロバイダのタスクルールに従って解釈すべきであり、常に新規生成区間のみを意味するとアプリケーションが仮定すべきではありません。
Audio-guided generation.
Alibaba はタイミングやリップシンクの挙動を駆動するソースとして音声を文書化しています。音声アセットをアップロードしない場合、モデルは一致する BGM や効果音を生成できます。リクエストした動画より長い音声は切り詰められ、短い音声の場合は残りの動画は無音になります。
Prompt extension, negative prompts and watermarking.
ネイティブ API はプロンプト拡張、ネガティブプロンプト、AI 生成のウォーターマークオプションをサポートします。これらの制御は、チームがプロンプト品質と出所挙動を標準化するのに役立ちますが、統一された CometAPI フィールドが 1 対 1 で対応しているとは限りません。
What Do Public Benchmarks Say About Wan 2.7?
動画モデルには、LLM の MMLU や SWE-bench に等しい単一の普遍的なベンチマークは存在しません。Wan 2.7 に関する最も明確な外部公開シグナルは、Design Arena の動画→動画カテゴリでトップになったことです。公式の掲載画像では、その時点で Wan 2.7 の Elo が 1335 と示されています。これは動画変換や編集の嗜好性に関する主張を裏付けますが、テキスト→動画、画像→動画、音質、レイテンシーにおける普遍的な優位性を証明するものではありません。
| Evidence | Public result | How to interpret it |
|---|---|---|
| Design Arena video-to-video | 1 位;掲載画像で Elo 1335 | V2V の優位性として強い証拠 |
| Official API specifications | 720P/1080P;T2V は 2–15 秒 | 品質ランキングではなく運用柔軟性の証跡 |
| Standardized T2V score | 非公開 | 普遍的な T2V 首位を主張しない |
| Standardized I2V score | 非公開 | 内部 A/B テストを実施 |
| Latency or success-rate benchmark | 標準化なし | 選択したルート上で計測 |
Benchmark Conclusion
- 動画→動画の競争力の証拠として Design Arena の結果を使い、すべてのモードに跨る包括的主張には使わない。
- Wan 2.1 のベンチマーク数値を Wan 2.7 の結果として再利用しない。
- 本番選定では、同じプロンプト、ソースアセット、解像度、長さ、音声条件でモデル比較を行う。
- 人的合格率、動きの安定性、アイデンティティ保持、レイテンシー、失敗率、承認クリップあたりのコストを追跡する。
Why Use Wan 2.7 Through CometAPI?
A Unified Video API
CometAPI は、共通の非同期動画ライフサイクルを通じてモデルを公開します。現在の Wan 2.7 モデルページは、顧客向けのモデル ID、ルート価格、動作する作成→ポーリング→ダウンロードのパターンを掲載しています。これは、複数の動画モデル間でテストまたはルーティングが必要な製品において、プロバイダ固有の統合コードを削減します。
POST /v1/videos GET /v1/videos/{video_id} GET /v1/videos/{video_id}/content

CometAPI における非同期動画生成の create→poll→download ライフサイクル。エンドポイント出典: CometAPI API documentation**.
- 複数のサポート動画モデルに対する 1 つの API キー
- タスク作成、ステータス取得、ファイルダウンロードの一貫したパターン
- 使用量と課金の一元的可視化
- 認証やレスポンススキーマのプロバイダ依存度を低減
- モデル選択をライフサイクル全体の置き換えなしに切り替え可能なため A/B テストが高速
A Necessary Compatibility Note
Route compatibility: CometAPI の統一 /v1/videos スキーマは、Alibaba Cloud のネイティブ T2V、I2V、R2V、動画編集 API のすべてのフィールドを必ずしも公開していません。基本的なテキスト→動画と画像→動画が最も安全な出発点です。最初/最後フレーム制御、複数リファレンス入力、オーディオドライビング、動画編集を公開する前に、ライブのルートフィールドとメディア制限を必ず検証してください。
What You Need Before You Start
Create a CometAPI Account and API Key
CometAPI アカウントを作成またはサインインし、API キーを生成 してください。環境変数に保存し、ソース管理、ブラウザコード、モバイルアプリにハードコードしないでください。
export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"
Know the Model ID and Endpoints
Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content
Install the Python Package
python -m pip install --upgrade requests
例は生の HTTP リクエストを使用します。これは、マルチパートフォームデータ、ステータスポーリング、バイナリダウンロードを、追加の SDK 抽象化なしで理解しやすくするためです。
How to Use Wan 2.7 API with CometAPI
Step 1: Create a Text-to-Video Task
model、prompt、duration、size を含むマルチパートリクエストを送信します。この 5 秒 720p の例は、認証情報、ルーティング、タスク作成を検証するための最もリスクの低い方法です。
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F "model=wan2.7" \ -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \ -F "seconds=5" \ -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{ "id": "video_task_id", "status": "queued", "progress": 0 }
Step 2: Poll the Video Status
返却された ID をステータスエンドポイントで使用します。計算集約的な動画タスクに対しては、10–15 秒間隔でのポーリングが、タイトなループより一般的に適切です。
curl https://api.cometapi.com/v1/videos/{video_id} \ -H "Authorization: Bearer $COMETAPI_KEY"{ "id": "video_task_id", "status": "in_progress", "progress": 45 }
アプリケーションは、completed または success を成功の終端状態として扱い、failed、error、または FAILURE を失敗の終端状態として扱うべきです。診断のため、失敗時のペイロード全体を保持してください。
Step 3: Download the Completed MP4
タスクが成功の終端状態に達した後にのみダウンロードしてください。不完全なタスクからのレスポンスを保存すると、空のファイルや、MP4 拡張子を持つエラードキュメントが生成される場合があります。
curl https://api.cometapi.com/v1/videos/{video_id}/content \ -H "Authorization: Bearer $COMETAPI_KEY" \ --output wan2_7_output.mp4
Step 4: Generate Video from an Image
画像→動画では、リファレンスをマルチパートフォームデータとしてアップロードし、動き、カメラ挙動、意図する時間変化を説明するプロンプトを使用します。統一ルートでは一般的に input_reference を使用します。本番前に、現在のファイルサイズ、形式、画像枚数のルールを確認してください。
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F "model=wan2.7" \ -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \ -F "input_reference=@reference.png" \ -F "seconds=5" \ -F "size=1280x720"
Image prompt tip: 参照画像に既に見えている静的コンテンツの再記述にプロンプトの大半を費やさないでください。モーション、カメラ指示、タイミング、変化、制約にプロンプトの予算を使いましょう。
Step 5: Build the Complete Python Workflow
以下のプログラムは、API キーの検証、タスク送信、ラップされたステータスレスポンスの正規化、最大待機時間の適用、終端失敗の処理、完了ファイルのダウンロードを行います。
import os import time from pathlib import Path import requests API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900 if not API_KEY: raise RuntimeError("Set COMETAPI_KEY before running this script.") headers = {"Authorization": f"Bearer {API_KEY}"} def parse_task_data(payload): return payload.get("data") or payload # 1. Submit the generation task. submit = requests.post( f"{BASE_URL}/videos", headers=headers, files={ "model": (None, "wan2.7"), "prompt": ( None, "A cinematic tracking shot of a futuristic train " "crossing a snowy mountain valley at sunrise." ), "seconds": (None, "5"), "size": (None, "1280x720"), }, timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id") if not video_id: raise RuntimeError(f"No video ID in response: {submit_payload}") print(f"Created video task: {video_id}") # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline: response = requests.get( f"{BASE_URL}/videos/{video_id}", headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() data = parse_task_data(payload) status = str(data.get("status", "unknown")) progress = data.get("progress", "unknown") print(f"status={status}, progress={progress}") if status in {"completed", "success"} or progress in {100, "100", "100%"}: break if status in {"failed", "error", "FAILURE"}: raise RuntimeError(f"Video generation failed: {payload}") time.sleep(POLL_INTERVAL) else: raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s") # 3. Download the completed MP4. video = requests.get( f"{BASE_URL}/videos/{video_id}/content", headers=headers, timeout=180, ) video.raise_for_status() output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content) if output.stat().st_size == 0: raise RuntimeError("Downloaded file is empty.") print(f"Saved {output} ({output.stat().st_size} bytes)")
Step 6: Call Wan 2.7 with JavaScript
この Node.js 例は組み込みの fetch と FormData を使用します。Node.js 18 以降を使用してください。例は node:fs/promises で結果を書き込みます。
import { mkdir, writeFile } from "node:fs/promises"; const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000; if (!apiKey) throw new Error("Set COMETAPI_KEY first."); const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)); const form = new FormData(); form.append("model", "wan2.7"); form.append( "prompt", "A cinematic tracking shot of a futuristic train crossing " + "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720"); const submitResponse = await fetch(`${baseUrl}/videos`, { method: "POST", headers, body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text()); const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`); const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) { const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers }); if (!statusResponse.ok) throw new Error(await statusResponse.text()); const payload = await statusResponse.json(); const data = payload.data || payload; const status = String(data.status || "unknown"); const progress = data.progress ?? "unknown"; console.log({ status, progress }); if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) { break; } if (["failed", "error", "FAILURE"].includes(status)) { throw new Error(`Generation failed: ${JSON.stringify(payload)}`); } await sleep(pollIntervalMs); } if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`); const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text()); await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);
What Are the Wan 2.7 API Parameters?
| Parameter | Type | Required | Example | Purpose |
|---|---|---|---|---|
| model | string | Yes | wan2.7 | ルートの選択 |
| prompt | string | Yes | Scene description | コンテンツ、動き、スタイルの定義 |
| seconds | integer | No | 5 | 長さとコストの制御 |
| size | string | No | 1280x720 | 解像度 / アスペクト比の制御 |
| input_reference | file | I2V | reference.png | 参照画像の提供 |
| Authorization | header | Yes | Bearer token | リクエストの認証 |
CometAPI and Alibaba Native Parameter Mapping
| Concept | CometAPI | Alibaba native API |
|---|---|---|
| Model | wan2.7 | wan2.7-t2v または wan2.7-i2v-* |
| Duration | seconds | duration |
| Resolution | size | resolution + ratio |
| Reference image | input_reference | media[].type=first_frame |
| Task identifier | id or task_id | output.task_id |
| Task status | GET /v1/videos/{id} | プロバイダのタスククエリエンドポイント |
| Binary result | GET /v1/videos/{id}/content | 一時的な結果 URL / プロバイダレスポンス |
このマッピングは、Alibaba Cloud の例を CometAPI にそのまま貼り付けられない理由を説明します。モデル能力は関連していますが、アクセスレイヤーとスキーマが異なります。
How to Write Better Wan 2.7 Prompts: Examples
実用的な動画プロンプトは、時間とともに何を安定して保ち、何を変えるべきかを定義します。次の構造を使ってください:
Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints
Single-Shot Prompt
A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.
Multi-Shot Prompt
Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.
Image-to-Video Prompt
Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.
Negative Prompt Guidance
ネガティブプロンプトは、望ましいシーンを再度説明するのではなく、繰り返し発生する失敗モードを抑制するために使用します。low resolution、deformed hands、duplicated limbs、flicker、unstable face、unreadable text、watermark のような簡潔なリストは、長く矛盾した段落よりも通常有用です。
How Much Does the Wan 2.7 API Cost?
現在の CometAPI ルートでは、Wan 2.7 は 720p が 1 秒あたり $0.08、1080p が $0.12 と記載されています。推定コストは、生成する長さと選択した解像度の直接関数です。
| Resolution | Price / second | 5 seconds | 10 seconds | 15 seconds |
|---|---|---|---|---|
| 720p | $0.08 | $0.40 | $0.80 | $1.20 |
| 1080p | $0.12 | $0.60 | $1.20 | $1.80 |
Estimated video cost = price per second x generated duration in seconds
データソース: CometAPI live model pricing**.
Pricing interpretation: 同一のリージョン、モデルバリアント、解像度、長さ、音声モード、課金単位を比較せずに、アグリゲータのルートが Alibaba Cloud より安いと主張しないでください。CometAPI の明確な秒単価と統一課金は統合上の利点ですが、プロバイダ価格での優位を主張するには同条件比較が必要です。クリエイティブ審査に落ちた 1080p クリップは、生成価格の記載以上に高くつきます。プロダクション計画では、再作業なしで承認されたクリップ数で総支出を割ってください。
Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1
同一プラットフォームで最も有用な代替は Seedance 2.5、Vidu Q3、Veo 3.1 です。以下の表は、普遍的な勝者を宣言するのではなく、ワークフロー適合性を比較します。ルート機能は変化しうるため、本番前に高度な入力を検証してください。
| Dimension | Wan 2.7 | Seedance 2.5 | Vidu Q3 | Veo 3.1 |
|---|---|---|---|---|
| Main positioning | 制御性の高いマルチモーダルスイート | 長尺の物語とリファレンス重視の生成 | 高速なストーリー志向の制作 | シネマティック動画(ネイティブ音声) |
| Text-to-video | Yes | Yes | Yes | Yes |
| Image-to-video | Yes | Yes | Yes | Yes |
| First/last-frame control | ネイティブファミリーでサポート | ルート依存 | サポート | 選択ワークフローでサポート |
| Video continuation | ネイティブファミリーでサポート | 編集志向 | ルート依存 | 拡張ワークフロー |
| Audio | 入力ガイダンス + 自動 BGM/SFX | 音声と動画のジョイント | ネイティブ同期音声 | ネイティブ同期音声 |
| Common route duration | ネイティブ T2V で 2–15 s | 掲載ルートで 4–30 s | 掲載ルートで 1–16 s | 公式モードで 4/6/8 s |
| Common maximum resolution | 1080p | ルート依存 | 1080p | 1080p(他バリアントは異なる場合) |
| Best fit | 制御重視のプロダクションワークフロー | 長尺のマルチショットストーリーテリング | 迅速な物語反復 | 高品位のシネマティックショット |
Comparison Results
- 最大の単一クリップ長よりも、最初/最後フレーム制御、継続、音声ガイダンス、広い制御可能なワークフローが重要な場合は、Wan 2.7 を選択。
- 参照重視の長尺ストーリーテリングを優先する場合は Seedance 2.5 を選択。
- 迅速な物語反復、同期音声、クリエイター志向ワークフローが中心なら Vidu Q3 を選択。
- 高いルートコストに見合うシネマティック品質、視覚写実、統合音声を求める場合は Veo 3.1 を選択。
- 仕様だけで勝者を決めないでください。固定のプロンプトとアセットを使用し、承認出力率と総生産コストで比較します。
Production Best Practices
Task Lifecycle and Reliability
- タスク作成直後にタスク ID を永続化する。
- クライアントのリトライで重複課金タスクを作らないための等冪戦略を実装する。
- 無限ループではなく、10–15 秒の間隔と最大待機時間を設けてポーリングする。
- 一時的な HTTP 障害と、プロバイダが宣言する生成失敗を区別する。
- ネットワークやレート制限エラーには指数バックオフを用いるが、コンテンツポリシー失敗は無闇に再試行しない。
- 出力をダウンロードし、空でないことを検証してからジョブ完了とマークする。
- 一時的なプロバイダ URL に恒久的に依存しない。許可される場合は受理出力を自社管理ストレージに複製する。
Quality and Cost Control
- 1080p マスターを生成する前に、720p・短尺でプロトタイピングする。
- 再現性のため、プロンプト、ネガティブプロンプト、model ID、ルート、解像度、長さ、タスク ID、出力ハッシュをセットで保持する。
- プロンプト遵守、モーション、時間的整合性、アイデンティティ、手、テキストアーティファクト、音声、安全性のレビュー基準を構築する。
- リクエスト単価だけでなく、承認出力あたりのコストを測定する。
- 小さな回帰プロンプトセットを維持し、ルートバージョンやモデルプロバイダを切り替える前に再実行する。
Security and Governance
- API キーはサーバー側で保持し、露出が疑われる場合はローテーションする。
- 生成ルートに転送する前に、画像・動画アップロードを検証する。
- 参照メディアに対して同意、肖像、知的財産の管理を適用する。
- 広告、ニュース、政治、医療など高インパクト用途には人間のレビューを追加する。
- 出所メタデータを保持し、法域やプラットフォームで要求されるウォーターマークや開示ポリシーを適用する。
Common Errors and Troubleshooting
| Error or symptom | Likely cause | Recommended fix |
|---|---|---|
| 401 Unauthorized | キーの欠落、無効、取り消し | Bearer トークンと環境変数を確認 |
| 400 Bad Request | 未対応フィールド、サイズ、長さ | モデルページの例から始め、フィールドを一つずつ追加 |
| No task ID | 予期しないレスポンスラッパー | レスポンス全体をログし、data、id、task_id を確認 |
| Queued for a long time | プロバイダの負荷・キャパシティ | 境界付きポーリングを継続し、タスクを複製しない |
| Generation failed | メディア、プロンプト、ポリシー、プロバイダエラー | 終端ペイロードを確認し、再試行の是非を判断 |
| Empty MP4 | 完了前のダウンロード、エラーボディを保存 | ステータスと Content-Type を確認してからファイル書き込み |
| Reference rejected | 形式、寸法、サイズ、メディア数 | PNG/JPEG に変換し、ライブルートの制限に従う |
| Unexpected cost | 長尺、高解像度、再試行 | 720p で試作し、承認出力率を追跡 |
| Inconsistent result | 生成の確率性、曖昧なモーションプロンプト | タイミングと制約を明記し、複数候補を比較 |
Final Recommendation
Wan 2.7 の実用価値は、テキスト→動画、画像アニメーション、アンカーフレーム、継続、リファレンス駆動生成、音声対応といった制御可能な広範な動画ワークフローにあります。CometAPI を通じた最短経路は、統一された非同期エンドポイントで 5 秒 720p のリクエストを検証し、タスク作成・ポーリング・ダウンロードが確実に動作することを確認した後に、画像入力や 1080p 出力を追加することです。
本番では、CometAPI の統一スキーマが Alibaba のすべての高度機能を公開しているとは限らないため、高度なネイティブ機能は明示的な能力チェックの背後に置いてください。Wan 2.7 を代替と同条件で比較し、見出し価格ではなく、承認動画あたりのコストが最も低いルートを選んでください。
FAQs
What is the Wan 2.7 API?
テキスト→動画、画像→動画、リファレンス誘導ワークフロー、動画編集をカバーする、API でアクセス可能なマルチモーダル動画生成ファミリーです。CometAPI は顧客向けルートを model ID wan2.7 で提供します。
What is the Wan 2.7 model ID on CometAPI?
wan2.7 を使用します。Alibaba ネイティブの wan2.7-t2v などに置き換えないでください(Alibaba Cloud を直接呼び出す場合を除く)。
Which endpoint creates a Wan 2.7 video?
マルチパートの POST リクエストを https://api.cometapi.com/v1/videos に送信します。次に /v1/videos/{video_id} を問い合わせ、/v1/videos/{video_id}/content からダウンロードします。
Does Wan 2.7 support text-to-video and image-to-video?
はい。どちらも掲載された機能です。画像→動画ではリファレンス画像を追加し、ルートの最新のマルチパートフィールド要件を使用してください。
What resolutions does Wan 2.7 support?
公開されている Wan 2.7 の動画ルートは 720p と 1080p をサポートします。ネイティブのテキスト→動画ドキュメントにも、両階層のアスペクト比ごとの出力寸法が記載されています。
How long can a Wan 2.7 video be?
Alibaba のネイティブ Wan 2.7 テキスト→動画 API は、整数の長さ 2–15 秒、デフォルト 5 秒を許容します。呼び出す CometAPI ルート固有の値に従ってください。
Does Wan 2.7 generate audio?
Alibaba は音声誘導生成と、音声未アップロード時の一致する BGM/効果音の自動生成を文書化しています。統一ルートで公開される正確な音声フィールドは、本番前に検証してください。
Can Wan 2.7 use first and last frames?
ネイティブの画像→動画ファミリーは、最初フレーム、および最初+最後フレームのワークフローをサポートします。CometAPI での対応フィールドは、採用前に確認してください。
Is the Wan 2.7 API synchronous or asynchronous?
非同期です。タスク作成は ID を返し、アプリケーションはステータスをポーリングし、完了後に結果をダウンロードする必要があります。
How much does Wan 2.7 cost on CometAPI?
公開ルートでは、720p が秒あたり $0.08、1080p が秒あたり $0.12 と記載されています。したがって 5 秒クリップの推定は、それぞれ $0.40 と $0.60 です。
Should I use Wan 2.7, Seedance 2.5, Vidu Q3 or Veo 3.1?
制御性の広さを重視するなら Wan 2.7、長尺で参照重視のストーリーテリングなら Seedance 2.5、迅速な物語反復と同期音声・クリエイター志向ワークフローなら Vidu Q3、シネマティック品質・視覚写実・統合音声に価値を置くなら Veo 3.1 を選択します。統制された A/B テストで選択を検証してください。
Can Wan 2.7 continue an existing video?
ネイティブの first_clip ワークフローで可能です。CometAPI の統一ルートでの可用性とパラメータマッピングは確認が必要です。
