Qwen Image Edit Spicy：衣装の部分編集ワークフロー

承認済みのポートレートで必要なのは、衣装の変更がたった一つ、ということがあります。たとえば、顔と帽子とポーズはそのままで、織りと落ち感の違うスカーフに替えたい場合です。画像エディターはその変更を提案できますが、写真の残りの部分を正確に保ちたいときは、適切な操作を選ぶことが重要です。

Qwen Image Edit Spicyが受け付けるのは、原画像1枚、編集指示1つ、任意のシードです。現在の料金は1枚あたり$0.038で、既存の構図にテキストで指示した変更を加える用途に向いています。マスクや原画像の強度の調整は期待しないでください。 顔や衣服の輪郭をすべて保ったまま正確に色を変えたい場合は、マスクを使う従来の色調整のほうが確実です。生成による衣装の提案が欲しい場合は、下の原画像と編集指示を使い、結果を元の原画像と比べてください。

成人の架空の例として、プラム色のブレザーとアイボリーのシャツを着て、淡いティール色のスカーフを巻き、バーントオレンジのフェルト帽を持った女性を使います。依頼する変更は、織りの粗い落ち着いた銅色のスカーフです。掲載しているイラストは依頼内容を示すもので、Qwenの保持性能を示すものではありません。

適切なQwenのタスクを選ぶ

Qwen Image Edit Spicyを開きます。公開IDはalibaba/qwen-image-spicy-edit/editです。これはQwen Image 2.1の編集やQwen LoRAのタスクとは別のものです。

この衣装の作業には、次の2つの制限があります。

• 領域の指定ができない: このタスクにはマスクも原画像の強度設定もありません。「〜だけを変更」という指示は望む結果を伝えるもので、画像の残りを固定するものではありません。
• 出力や調整のコントロールがない: 他のQwenタスクにある解像度、アスペクト比、出力形式、ネガティブプロンプト、LoRAのフィールドは、ここでは受け付けられません。最終的なトリミングを準備する前に、返されたファイルを確認してください。

より一般的なQwen Image Editの紹介では、意味的な編集と見た目の編集が扱われています。そこからは、このホスト型Spicyタスクの正確なベースの版や内部の仕組みは分かりません。実際のリクエストには、このタスクの現在のフィールドを使ってください。

スカーフ全体が見える原画像を1枚用意する

元のウエストアップのポートレートを使い、スカーフの下側の折り返し、ブレザーの両方の襟、手、帽子のつば全体が入るようにします。スカーフだけを切り出さないでください。意図しない変化に気づくには、返された同じ画像に顔と帽子が必要です。スカーフが髪で一部隠れていても編集はできますが、原画像で見分けられない境界までプロンプトで守ることはできません。

イラストであり、対象モデルの結果ではありません。スカーフ全体、襟、手、帽子が見える構図が、原画像を保つための具体的な依頼内容になります。

実在の人物の場合は、処理する許諾のある原画像を使ってください。キャラクターのシリーズでは、失敗した版で顔が変わったら同じ承認済みポートレートに戻り、失敗した顔を次のマスターにしないでください。

色の変更と新しい衣服を分ける

衣装の編集で頼めることは、大きく3つあります。色の変更は、縫い目の位置、素材、落ち感を保ちます。素材の変更は、衣服のデザインを保ったまま、光の反射の仕方を変えます。置き換えは、襟、ストラップ、留め具、カットまで変えます。この3つを「服をもっと魅力的に」という一言にまとめると、どの人物の特徴やポーズを描き直すかをモデルに任せることになります。

スカーフなら、「落ち着いた銅茶色の織物」は色と表面の質感を示します。一方、「銅色のスカーフ」は金属を連想させることもあり、下の表にある光沢が出る失敗の原因になります。サテンなら、生地のベースの色とハイライトを分けて指定します。ハイライトは淡いまま、生地の本体だけをバーガンディにすることもできます。完全に均一な色を求めると、生地らしく見せる光や折り目の情報が消えてしまいます。

架空の成人キャラクターの衣装シリーズでは、顔と衣服の境界がはっきり見える承認済みの原画像から始めます。最初は衣服1点だけの変更を依頼します。できた衣装は使えるが光の当たり方がおかしい場合は、採用した版から照明の修正版を作ります。顔がおかしい場合は、元の画像からやり直します。変わってしまった顔の上で編集を重ねると、その顔が少しずつ原画像になってしまいます。

別の部分を覆う新しい衣装では、モデルが補わなければならない情報も変わります。原画像には、別の衣服の見えない構造や、隠れた手は写っていません。衣装を試している間は、ポーズとカメラの視点を固定して、新しい衣装の結果が新しい身体構造や遠近の解決まで要求しないようにします。これは、矛盾する指示を減らすための提案であり、このエンドポイントで検証した成功率ではありません。

Playgroundでスカーフの編集を試す

1. モデルページでPlaygroundタブを開き、Input imageに承認済みポートレートを追加します（JPG、PNG、WEBP、GIF、10 MBまで）。ファイルをアップロードするか、Asset URLとAdd URLで直接ダウンロードできる公開リンクを貼り付けます。ビューアーのページや、有効期間の短い署名付きリンクは失敗します。
2. Promptに次を入力します。「Change only the pale-teal scarf to muted copper woven fabric with heavier texture. Keep its wrap, the face, plum blazer, ivory shirt, hands, orange hat, lighting and framing.」
3. Seedは空のままにするか、同じシードで表現を比べるために314159を入力します。Run modelを押し、顔、スカーフ、帽子を原画像と比べます。

承認済みの設定をAPIで使う

環境にSPICY_API_KEYを設定します。SOURCE_IMAGE_URLには、承認済みポートレートの直接のHTTPS URLを設定します。手元のコンピューターにあるファイルは、先にメディアガイドの手順でアップロードしてください。Python 3で実行し、表示された見積もりは、新たに有料で試す場合にのみ承認してください。

import json
import os
import uuid
from pathlib import Path
from urllib.request import Request, urlopen

payload = {"model": 'alibaba/qwen-image-spicy-edit/edit', "input": {
    'image_url': os.environ['SOURCE_IMAGE_URL'],
    'prompt': "Change the pale-teal scarf to muted copper woven fabric with a heavier weave and soft folds. Keep its wrap and placement around the neck. Retain the adult woman's face, hairstyle, plum blazer, ivory shirt, hand positions, burnt-orange felt hat, studio background, lighting and camera framing. The scarf remains fabric, not metallic jewelry.",
    'seed': 314159,
}}

def api(action, body, key=None):
    headers = {"Authorization": "Bearer " + os.environ["SPICY_API_KEY"],
               "Content-Type": "application/json"}
    if key:
        headers["Idempotency-Key"] = key
    request = Request("https://api.spicyapi.ai/api/v1/jobs/" + action,
                      data=json.dumps(body).encode(), headers=headers)
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("code") != 200:
        raise RuntimeError(result)
    return result["data"]

quote = api("quote", payload)
print("Maximum charge (USD):", quote["maxCharge"])
if input("Create this new attempt? Type yes: ").strip() != "yes":
    raise SystemExit("No task created")
key = str(uuid.uuid4())
body = {**payload, "quoteId": quote["quoteId"],
        "expectedCost": quote["estimatedCost"]}
Path(key + ".json").write_text(json.dumps({"key": key, "request": body}))
task = api("createTask", body, key)
Path(key + ".task.json").write_text(json.dumps(task))
print("Task ID:", task["taskId"])

保存されたキーは、同じリクエストを再試行するときのために取っておいてください。結果の取得とファイルの扱いはタスクAPIガイドにあります。

繰り返し編集する場合は、Agentに承認済みの依頼内容を任せられます。

• CLI: npx @spicyapi/cli tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait。input.jsonには{"image_url": "...", "prompt": "..."}を入れます。
• MCP: spicyapi_task_create、続いてspicyapi_task_waitを使うよう依頼します。
• Skill: npx skills add spicyapi-ai/spicy-skillでインストールし、spicyapi Skillに、見積もりを表示したうえでこの設定を実行するよう依頼します。

見えている失敗に合った修正をする

色だけを変えるシンプルな依頼なら、通常の仕上げで十分なことが多くあります。レイヤー対応のエディターでスカーフを選択し、その選択範囲に色相の変更を適用して、顔と帽子の元のレイヤーはそのまま残します。スカーフの素材や落ち感を変えたい場合は、生成による提案が役立ちますが、それはより広い衣装の変更になります。

マスクが必要なとき

Qwen Image 2.1 editには、別途mask_urlのコントロールがあります。白黒のマスクで、白が描き直す範囲、黒が保つ範囲を示し、参照画像はちょうど1枚です。マスクは1kと2kに対応し、料金は1枚あたりそれぞれ$0.036と$0.048です。これは別のタスクであり、Spicy Editに足せる追加フィールドではありません。元のポートレートを唯一の原画像としてアップロードし、スカーフとその境界を編集領域に含めます。

領域を指定できるエディターでも、あとで顔、帽子、襟を比べてください。納品物でスカーフ以外の元のピクセルが完全に同一である必要があるなら、生成による保持の指示を保証として示すのではなく、採用したスカーフの処理を従来のレイヤーマスクで元の画像に合成します。

イラストであり、対象モデルの結果ではありません。生地は色の方向性を表しています。この別の企画用プリントは、対応するビフォーアフターの結果ではありません。

過去の成人向けテストで分かることと分からないこと

2026年9月のテストでは、Spicy Editは成人向けコンテンツの5つのカテゴリすべてで、依頼した編集を返しました。テスト結果には、実際のビフォーアフターの組が含まれています。検閲なしのコンテンツ処理だからといって、原画像の保持が自動的に保証されるわけではありません。編集が完了しても、顔や手が変わることはあります。

$0.038なら、意図した候補2枚で合計$0.076です。何枚試しても、ポートレートが保たれる保証はありません。

おおよその生成による変更で足りるなら、原画像1枚のリクエストから始めてください。周囲のポートレートを正確に保つことが中心の要件なら、実際にマスクに対応したタスクか、通常の仕上げを選んでください。

よくある質問

Qwen Image Edit SpicyはQwen Image 2.1の編集と同じタスクですか。

いいえ。Spicy Editが使うのはimage_url1つと任意のシードです。別の2.1の編集タスクはmask_urlを受け付けます。そのマスクを使うときは、参照画像をちょうど1枚指定してください。両者のフィールドを組み合わせず、リクエストをコピーする前にタスクを選んでください。

スカーフ以外のピクセルをすべて変えずに保てますか。

このタスクには、それを強制するマスクがありません。色だけの変更なら、従来のエディターで選択範囲を作ります。生成による素材の変更で、周囲のピクセルを変えたくない場合は、採用したスカーフの領域を元の画像に合成し直します。

シードを使えば同じ顔が保たれますか。

シードは生成の試行を制御するもので、顔を保つためのものではありません。承認済みの原画像を保ち、実際の出力で顔、生え際、手、衣服の境界を比べてください。

送信後に応答を失った場合、再試行できますか。

同じリクエストに同じIdempotency-Keyを付けて送ります。上のスクリプトは、両方を<key>.jsonに保存します。24時間の期間については、冪等性ガイドを参照してください。新しい試行を始めると、別の有料の画像になります。