MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/CometAPIリサーチ

Wan 2.7 API の使用方法:開発者向け完全ガイド

CometAPI 経由で Wan 2.7 API を使用し、テキストから動画および画像から動画を生成する方法を、例、料金、比較、およびベストプラクティスとともに学びましょう。

CometAPI
Mia MarenAIモデルとAPIの調査チーム
更新日 Sep 3, 2026 11 分読み
Wan 2.7 API の使用方法:開発者向け完全ガイド
このパターンを使う

最初のAPI呼び出しを行う。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

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

SpecificationWan 2.7 Video
ProviderAlibaba / Wan
CometAPI model IDwan2.7
Native text-to-video IDswan2.7-t2v, wan2.7-t2v-2026-06-12
Native image-to-video IDwan2.7-i2v-2026-04-25
Main inputsテキスト;サポートされるワークフローでは画像、音声、動画
Main outputサポートされる音声動作を伴う生成動画
ModesT2V, I2V, R2V, 動画編集、最初/最後フレーム、継続
Resolution720P と 1080P
T2V duration2–15 秒;デフォルトは 5 秒
T2V aspect ratios16:9, 9:16, 1:1, 4:3, 3:4
Prompt limitネイティブ Wan 2.7 T2V では 5,000 文字
Negative prompt limit500 文字
Audio formats and limitsWAV/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 と示されています。これは動画変換や編集の嗜好性に関する主張を裏付けますが、テキスト→動画、画像→動画、音質、レイテンシーにおける普遍的な優位性を証明するものではありません。

EvidencePublic resultHow to interpret it
Design Arena video-to-video1 位;掲載画像で Elo 1335V2V の優位性として強い証拠
Official API specifications720P/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

Wan 2.7 API の使用方法:開発者向け完全ガイド

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?

ParameterTypeRequiredExamplePurpose
modelstringYeswan2.7ルートの選択
promptstringYesScene descriptionコンテンツ、動き、スタイルの定義
secondsintegerNo5長さとコストの制御
sizestringNo1280x720解像度 / アスペクト比の制御
input_referencefileI2Vreference.png参照画像の提供
AuthorizationheaderYesBearer tokenリクエストの認証

CometAPI and Alibaba Native Parameter Mapping

ConceptCometAPIAlibaba native API
Modelwan2.7wan2.7-t2v または wan2.7-i2v-*
Durationsecondsduration
Resolutionsizeresolution + ratio
Reference imageinput_referencemedia[].type=first_frame
Task identifierid or task_idoutput.task_id
Task statusGET /v1/videos/{id}プロバイダのタスククエリエンドポイント
Binary resultGET /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 と記載されています。推定コストは、生成する長さと選択した解像度の直接関数です。

ResolutionPrice / second5 seconds10 seconds15 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 です。以下の表は、普遍的な勝者を宣言するのではなく、ワークフロー適合性を比較します。ルート機能は変化しうるため、本番前に高度な入力を検証してください。

DimensionWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Main positioning制御性の高いマルチモーダルスイート長尺の物語とリファレンス重視の生成高速なストーリー志向の制作シネマティック動画(ネイティブ音声)
Text-to-videoYesYesYesYes
Image-to-videoYesYesYesYes
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 resolution1080pルート依存1080p1080p(他バリアントは異なる場合)
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 symptomLikely causeRecommended 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 の統一ルートでの可用性とパラメータマッピングは確認が必要です。

学習を続ける

この記事を次の判断につなげる。

すべてのトピックを見る
公開日 Aug 31, 2026
最終更新 Sep 3, 2026
19 回視聴
明確性、出典の帰属、最新のAPI用語について確認済みです。

もっと読む