Wan 2.7
Wan 2.7 Image と Image Pro の制限 — 厳密に検証される 5 種のアスペクト比と、Pro のみで使える 4K。
Wan 2.7 は ListenHub における Alibaba の画像モデルファミリーで、wan2.7-image と wan2.7-image-pro
があります。どちらも共通の画像エンドポイントで動作します。エンドポイント、リクエストスキーマ、非同期の流れ、
エラーコードについては 画像生成の概要 を参照してください。
本ページで扱うのは Wan 2.7 固有の内容だけです。
モデル
| モデル | 表示名 | 主な用途 |
|---|---|---|
wan2.7-image | Wan 2.7 Image | よく使う 5 種の比率でコスト効率のよい生成 |
wan2.7-image-pro | Wan 2.7 Image Pro | 同じ 5 種の比率に 4K 出力を追加 |
どちらも provider: "alibaba" を指定します。
制限
| 制限項目 | wan2.7-image | wan2.7-image-pro |
|---|---|---|
| 画像サイズ | 1K、2K — 4K は 400 が返ります | 1K、2K、4K（下記参照） |
| アスペクト比 | 1:1、16:9、9:16、4:3、3:4 | 1:1、16:9、9:16、4:3、3:4 |
| デフォルトのアスペクト比 | リクエストスキーマ由来の 1:1 | リクエストスキーマ由来の 1:1 |
| 参照画像 | 最大 9 件 | 最大 9 件 |
quality | 無視されます | 無視されます |
Wan 2.7 は、形状についてカタログの中で最も厳格なファミリーです。サイズとアスペクト比の両方を独自の
許可リストと照合し、上記の 5 種がその全部です。2:3、3:2、4:5、5:4、21:9 と極端な 4 種の比率は、
いずれも対応する比率の一覧をメッセージに含む 400 が返ります。この 5 種以外の形状が必要な場合は
Nano Banana Flash か Seedream を選んでください。
4K はテキストから画像のみ
wan2.7-image-pro が 4K をレンダリングするのは、リクエストに参照画像が含まれていない場合だけです。
imageSize: "4K" と空でない referenceImages 配列を組み合わせると、code: 26019 と汎用メッセージ
Unsupported aspect ratio for this model を伴う 400 が返ります — 具体的な理由はサーバー側にログされるだけで、
レスポンスには返りません。参照画像を使った生成では 2K に下げるか、4K を使うなら参照画像を外してください。
wan2.7-image は、参照画像の件数にかかわらず 4K を一律に拒否し、code: 29003 を返します。
参照画像はどちらのモデルも 1 リクエストあたり 9 件までです。超えると
Wan2.7 image models support at most 9 reference images とともに 400 が返ります。
料金
どちらのモデルも画像サイズごとの固定クレジットコストで課金され（pricing.mode は fixed）、どちらも
requiresSubscription を設定することはありません。
無料枠は 2 つのティアで異なります。wan2.7-image には 1K と 2K で使える無料枠リソースがありますが、
wan2.7-image-pro にはどのサイズでも無料枠がなく、常にクレジットで課金されます。正確な数値は
POST /v1/images/generation/estimate-credits
を呼び出して取得してください。
例
curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/async" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "alibaba",
"model": "wan2.7-image-pro",
"prompt": "A quiet reading room at golden hour, warm wood, soft shadows",
"imageConfig": { "imageSize": "4K", "aspectRatio": "16:9" }
}'完全なパラメータ一覧と参照画像を含むリクエストの形式は、 画像生成の概要 を参照してください。