はじめに
Wan 2.7 Pro 画像編集は、渡した画像に狙いを定めた変更を加えます。部分的な、あるいはスタイル上の判断を変えつつ、元画像のディテールを見分けられる状態に保ちたいときに使います。
手元の素材から Wan 2.7 Pro のモードを選ぶ
| 最初に手元にあるもの | モード |
|---|---|
| 文章のビジュアルブリーフ | Wan 2.7 Pro テキストから画像 |
| 狙いを定めた変更が必要な画像 | Wan 2.7 Pro 画像編集 |
主な機能とハイライト
text-to-image で 4K まで
ここの text-to-image は既定で 2k(約 400 万画素)、4k(約 1,600 万画素)まで上げられます。標準の Wan 2.7 は 2k が上限です。image-to-image は 2k で動きます。この分け方こそが要点で、4k はトリミングや印刷を前提にしたメインビジュアルを生成するときに使い、パッケージ写真の色替えには使いません。
蝋燭の光、肌、筆致
このページの 2 枚目は絵画的な室内です。逆光の屏風を背にした人物と、漆の卓に置かれた蝋燭 1 本とワイングラスが描かれています。柔らかい光の減衰、見える筆の質感、そのサイズで読める顔は、小さなキャンバスでまず崩れるものであり、まさに大きなキャンバスの用途です。
長い指示のどの一節も取りこぼしません
image-to-image では、その余力が複合的な指示に従うことへ向かいます。「この物体を取り、あの面に置き、2 枚目の光に合わせ、結露はそのままにする」といった指示です。標準版はこの種の指示のうち 1 節を落とす頻度が、こちらより高くなります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 変更点と、変えてはいけないもののリストを書いてください。このエンドポイントは複合的な指示のために調整されているので、光の向き、色温度、触ってはいけない部分まで名指しする価値があります。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 1 回の呼び出しで参照を 1〜9 枚渡せます。並び順に意味があり、プロンプトは位置で参照します。 1 件以上 · 9 件以内 |
bounding_boxes | いいえ | 編集を行う位置を示す任意の矩形で、参照画像 1 枚につき 2 個までです。 |
aspect_ratio | いいえ | 指定できるのは 1:1、4:3、3:4、16:9、9:16、3:2、2:3 です。既定はありません。 |
color_palette | いいえ | 3〜10 色の任意の配色テーマです(推奨は 8 色)。各色を #RRGGBB の 16 進コードで入力し、必要なら画像の何パーセントを占めるかも指定します。 3 件以上 · 10 件以内 |
seed | いいえ | 0〜2147483647 の整数です。変化形のセット全体で固定すれば、2 つの編集の唯一の差が、書き換えた 1 節だけになります。 |
料金
$0.075 / 枚
ユースケース
承認済みの画像を新しいキャンペーンに合わせる
商品写真と置きたい面を、ラベルを付けた 2 枚の参照として送り、2 枚目の光の向きと色温度に合わせるよう頼みます。結露、ラベル、ガラスの形は、明示的にそう書いたので変わりません。
管理されたアートディレクションの変更を試す
参照画像のポーズと衣装は残し、同じ指示の中で光や場面を変えます。このエンドポイントは複合的な指示に合わせて調整されているので、光の向き、色温度、動かしてはいけない部分を書いてください。
一貫したバリエーションのセットを用意する
バリエーションのセット全体で seed を固定すれば、2 つの編集の違いは変えた部分だけになります。編集はすべて 2k(約 400 万画素)の画面で行われ、4k はテキストから画像でのみ使えます。
プロンプトガイドと実践のヒント
残すものと変えてよいものを書く
元画像は 1 枚目、2 枚目と位置で呼び、変更を書いたあとに、変えてはいけないものの一覧を書きます。参照画像が 1〜9 枚あるなら、それぞれの役割を書いてください。aspect_ratio を省くと、最後の参照画像が比率を決めます。
手直しは部分ごとに確かめられるようにする
1 リクエストで返るのは 1 枚です。seed とほかの入力を固定したまま呼び出しを繰り返してバリエーションを作り、1 回に 1 か所だけを変え、結果は直前の編集ではなく元画像と比べてください。
元画像に左右される結果を確かめる
参照画像は、JPEG、透過のない PNG、BMP、WEBP のいずれかで、1 辺 240〜8,000 ピクセル、縦横比 1:8〜8:1、20 MB 以下である必要があります。aspect_ratio を変えると画面は切り抜きではなく組み直されるので、残した要素が本来の位置にあるかを確認してください。
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/wan-2.7-pro/edit",
"input": {
"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 リファレンスを参照してください。





























