EC製品撮影のためのWan 2.7 テキストtoイメージ：1回のAPI呼び出しで4Kスタジオ品質の画像を生成

このガイドのすべての画像は、執筆中にhiapiのタスクAPI経由でwan2.7-image/text-to-imageによって生成されました——掲載されているプロンプトは実際に使用されたものであり、所要時間もこれらの実行の実測ウォールクロック時間です。オンラインで販売していて、商品リスティング画像、シーン画像、パッケージのモックアップ、拡大表示可能なディテール画像が必要だが、スタジオを予約したくない場合、これが求めるワークフローです。

製品撮影にWan 2.7 Imageを使う理由

Wan 2.7 Image Pro（モデルID wan2.7-image/text-to-image）は通義万相のフラッグシップテキストtoイメージモデルです。EC業務に特に適した3つの特徴があります：

• 最大4K出力に対応。 ECプラットフォームのズームビューアやオンデマンド印刷は、一般的な1Kデフォルト値よりも多くのピクセルを求めます。Wan 2.7は4096×4096をネイティブサポート——アップスケーリング処理は不要です。
• 強力なプロンプト追従能力。 製品画像は構図的なものです：このボトルを、あの表面に置き、こちら側から光を当てる。私たちの実行では、素材の記述（「すりガラス」「ブラッシュアルミ」）、光の方向、小道具の配置が一度で決まりました。
• 統一価格。 hiapiでは任意の解像度で1枚あたり$0.08——1K、2K、4Kが同じ料金です（最新の価格ページで確認済み）。ほとんどのハイエンドモデルは4Kに追加料金を課すため、4Kを中心とするワークフローなら統一料金の方が経済的です。詳細な比較は後述します。

また、英語と中国語の両方のプロンプトを受け付けます。製品コピー制作チームが中国語を使いながら店舗が英語圏向けの場合、これは重要です。

クイックスタート：1回のPOST、1回のポーリング

Wan 2.7 Imageはhiapiの非同期タスクAPI上で動作します。タスクを送信し、完了するまでポーリングしてから出力をダウンロードします。まずクイックスタートガイドでAPIキーを取得してください。

送信：

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image/text-to-image",
    "input": {
      "prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

レスポンスのdata.taskIdにタスクIDが含まれます。statusがsuccessになるまで詳細エンドポイントをポーリングします：

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
    r = requests.post(API, headers=HEADERS, json={
        "model": "wan2.7-image/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
                  "resolution": resolution},
    })
    task_id = r.json()["data"]["taskId"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            return requests.get(task["output"][0]["url"]).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)

png_bytes = generate("...")  # save immediately — see the expiry note below

私たちの実行では、タスク作成は約2秒で返り、2K生成は60〜75秒で完了し、4K画像は86秒かかりました。ポーリングのオーバーヘッドを含め、1枚あたり約1分半を見込んでください。

本番環境に組み込む前に、2つの運用上の注意点があります：

1. 出力URLは期限切れになります。 output[0].urlにはexpireAtタイムスタンプが含まれます——これは一時リンクであり、CDNリソースではありません。タスクが成功した瞬間にバイトをダウンロードして自社のストレージに保存してください。この問題に過去に悩まされたことがあるなら、hiapiの出力URLが404を返す理由とその対処法で失敗パターンを書いています。
2. アスペクト比のリストは厳格です。 Wan 2.7 Imageは1:1、16:9、4:3、21:9、3:4、9:16、8:1、1:8のみを受け付けます。それ以外の比率——3:2や4:5のような一般的な写真比率を含む——は400 INVALID_REQUESTを返し、メッセージに許可リストが記載されます。実際に遭遇しました：1536×1920のリクエスト（4:5に簡約可能）が拒否され、3:4で再送信すると成功しました。Instagramの4:5が必要なら、3:4で生成してからトリミングしてください。

すべての製品リスティングに必要な4種類の画像

以下は4つの典型的なEC画像タイプで、それぞれ実際に使用したプロンプトと未編集の出力を添えています。

1. 白背景のメイン画像

Amazon、eBay、ほとんどのECプラットフォームはメインリスティング画像に純白背景を要求します。プロンプトの要点：背景を明示的に指定する（「継ぎ目のない純白背景」）、製品が浮かないように「柔らかな接地影」を要求する、照明設定を写真家のように記述する。

Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

1:1 / 2Kで生成、所要時間61秒。素材のレンダリング——拡散を通してスポイトが見えるすりガラス、キャップのブラッシュメタルテクスチャ——これが「強力なプロンプト追従能力」の成果です。

2. シーン画像

サブリスティング画像は使用シーンを伝えるために使います。製品を顧客が使うと想像する場所に置き、プロンプトにスタイリング要件を担わせます：表面、小道具、光の方向、被写界深度。

A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

要件のすべての要素が揃いました：大理石カウンター、折りたたまれたタオル、ユーカリ、左からの窓光、背景の減衰。これはプロンプト追従能力が最も重要な画像タイプです。余分な小道具や欠けた小道具は再生成を意味するからです。

3. 読みやすいブランド文字付きのパッケージ画像

文字レンダリングは、ほとんどの画像モデルが製品関連の作業で失敗するポイントです。短く明確な文字はWan 2.7で確実にレンダリングされます——正確な文字列を引用符で囲み、タイポグラフィを記述します：

Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

「VELA」は一字一句そのままレンダリングされました。テスト実行での正直な注意点：これはあなたが明示的に指定した短い文字列に当てはまります。バナー画像の初期草稿でラベルをモデルの自由に任せたとき、ボトル上にもっともらしい乱码（「SERUM SERUE」）を発明しました——ですから欲しい正確な文字を引用するか、「ラベルなし、文字なし、ロゴなし」とプロンプトして後でラベルを追加してください。生成画像内の文字は必ず公開前に校正してください。

4. 4Kマクロディテール画像

拡大ディテール画像はプレミアム価格を支えます。ここで4K出力と統一料金が活きます——同じ$0.08で4096×4096のファイルが手に入ります：

Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

フル解像度ファイルは4096×4096（最適化JPEGで約1.2 MB）で、ECプラットフォームのズームビューアでもアップスケーリングなしで鮮明さを保ちます。

ECワークロードの比較

以下のすべての価格は執筆時点のhiapiの実勢1枚あたり料金です——最新の数字は価格ページを確認してください。

モデル	1K	2K	4K	最適な用途
wan2.7-image/text-to-image	$0.08	$0.08	$0.08	4K中心のワークフロー、プロンプト重視の構図
gpt-image-2/text-to-image	$0.03	$0.04	$0.06	1K〜2Kで十分な大量カタログ
nano-banana	$0.05	—	—	速度（1枚あたり1〜2秒）、高速イテレーション
nano-banana-pro	$0.17	$0.17	$0.2992	ハイエンドブランド素材、大量の文字レンダリング

私たちが推奨する判断基準：リスティングに4Kが必要なら、Wan 2.7は製品ラインの中で最も安い4Kオプションであり、統一料金によってコスト予測が非常に簡単になります。1K〜2Kで十分で量に制約があるなら、gpt-image-2が予算の主力です。方針を決める前に構図を何十回もイテレーションするなら、nano-bananaの1〜2秒生成で高速ループを維持できます——その後、勝ち案をWan 2.7で4Kに再レンダリングします。

完全な製品リスティング——メイン画像、シーン画像、パッケージ画像、マクロ画像——はWan 2.7で$0.32かかり、タスクを並行実行すればウォールクロック時間は5分未満です。

まとめ

wan2.7-image/text-to-imageはECチームにスタジオ品質の製品撮影を1回の非同期API呼び出しで提供します：任意解像度で最大4Kが統一$0.08、構図要件への強い追従、パッケージ上の短い文字の確実なレンダリング。厳格なアスペクト比リストに注意し、URLが期限切れになる前に出力をダウンロードし、生成された文字を校正してください。

自分のカタログで試す準備はできましたか？APIキーを取得し、Wan 2.7 Image Proモデルページから始めてください。非同期APIクイックスタートで約90秒以内に最初の4K製品画像がレンダリングされます。