はじめに
Qwen Image 2 画像編集は、参照画像 1 枚と指示を受け取り、編集した結果を 1 枚返します。光を変える、スタイルを変える、服を着せ替える、文字を書き加えるなど、内容はプロンプトのとおりです。
Qwen Image 2 は Alibaba の汎用画像モデルです。プロンプトは中国語か英語で 800 文字まで、テキストから画像ではアスペクト比が 5 種類、編集エンドポイントでは参照 1 枚を指定した比率で作り直します。1 リクエストにつき 1 枚が返り、比較するあいだは任意の seed で同じ乱数を保てます。
手元の素材から Qwen Image 2 のモードを選ぶ
| 手元の素材 | モード |
|---|---|
| 文章のアートディレクションやデザインブリーフ | Qwen Image 2 テキストから画像 |
| 手直ししたい承認済みの元画像 | Qwen Image 2 画像編集 |
主な機能とハイライト
2 か国語でプロンプトを書ける
Qwen Image 2 は中国語と英語のプロンプトを直接読みます。チームはブリーフがいちばん明確に書ける言語のまま作業でき、引き継ぎのために書き直す必要がありません。
渡した 1 枚に、文章で変更を加える
編集モードは、渡した 1 枚の画像と文章の指示から始まります。人物や構図がすでに決まっていて、確認したいのが新しい案ではなく意図した変更である場合に使います。
出発点がはっきり分かれた 2 つのモード
テキストから画像はアートディレクションから新しい場面を立ち上げるためのもの、画像編集は元の画像を手直しするためのものです。先に出発点の素材を決めておけば、編集のブリーフを新規生成と同じ基準で評価してしまうことがありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 800 文字で、元画像ではなく結果を書きます。変えてはいけない部分と変える部分をはっきり書いてください。 1 文字以上 · 800 文字以内 |
image_urls | はい | 権利を持つ画像の、公開取得できる jpeg / png / webp の URL をちょうど 1 件。2 枚目はリクエストがプラットフォームを出る前に拒否されます。 1 件以上 · 1 件以内 |
aspect_ratio | いいえ | 既定は 1:1 で、ほかに 4:3、3:4、16:9、9:16、3:2、2:3、21:9。出力は元画像の形に従わないので、比率を保ちたいときは写真に合う比率を指定してください。 |
seed | いいえ | 省略すると毎回新しく引き直します。同じ編集に対する 2 つの言い回しを、同じ乱数で比べたいときに指定してください。 |
料金
$0.035 / 枚
ユースケース
手元の画像を仕上げる
既存の写真で被写体、構図、スタイルを決めたいときに使います。image_urls にその 1 枚だけを入れ、変える点と変えてはいけない点を書き、使う大きさで元画像と見比べます。
製品を新しい場面に置く
製品写真を送り、置きたい環境を、受けるべき光まで含めて書きます。1 回の呼び出しで 1 枚です。環境を別の写真から持ってくる必要があるなら、複数の参照を受け付ける編集モデルを使ってください。
2 か国語のキャンペーン制作
承認済みのキービジュアルを別の市場向けにするときは、何も書かれていない面に文字を入れるよう指示し、その文字を中国語か英語で、表示どおりにプロンプトへ書きます。短い文字列にとどめてください。看板や長い文章は Qwen Image 3.0 系の仕事です。
キャラクターと衣装
1 枚の写真から人物を残し、新しい服を素材と光沢まで言葉で説明します。aspect_ratio は写真の形に合わせてください。既定値は 1:1 なので、そのままだと頼んでいない正方形になります。
プロンプトガイドと実践のヒント
書く前に画角を決める
出力の形を決めるのは元画像ではなく aspect_ratio です。既定値は 1:1 で、3:2、2:3、21:9 を含む 8 種類から選べます。指示を書く前に、写真に合う比率を設定します。
800 文字を 1 つの完成した場面に使う
元画像ではなく、結果を書きます。まず変えてはいけないもの、次に変えるものを書き、残りを新しいセットと光に使います。書かなかった部分は変わってしまうことがあります。
付属の例を作り替える
公開している例から始め、演出を入れ替えつつ、このモードの入力の決まりはそのまま保ちます。
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
参照 1 枚での場面の置き換えです。女性とローブは残し、ネオンのバーは言葉で描き、光を合わせることも明記しています。画像はご自身で用意してください。ここの URL は仮のもので、ホストされたサンプルではありません。
反復する前に結果を確かめる
ここには強度の調整はなく、受け付ける参照は 1 枚だけです。2 枚目はリクエストがプラットフォームを出る前に拒否されます。aspect_ratio の既定値は 1:1 で元画像には合わせないため、縦位置の写真も比率を指定しなければ正方形で返ります。元画像がどれだけ残るかは、指示の具体性で決まります。同じ編集の 2 通りの書き方を同じ乱数で比べたいときは、seed を固定します。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
