はじめに
Qwen Image Edit Spicy は、元画像 1 枚を平易な英語の指示 1 つで編集します。マスクも範囲の選択も、どれだけ変えるかの調整もありません。文章だけが操作のすべてで、守られるのは名前を挙げたものだけです。
リクエストは image_url、prompt、任意の seed です。seed を 0 にするとランダムな乱数になります。1 リクエストにつき 1 枚が返ります。
主な機能とハイライト
マスクも強度も、インペイントの手順もない
多くのエディターでは、何かを変える前に範囲とどれだけ変えるかを選ばされます。これは文章を 1 つ受け取るだけです。変えるものと残すものを書いて送ります。強度の調整がないのは意図したものです。何を守るかを言葉で表すので、あとで編集を確かめるときもその言葉で追えます。
大胆な衣装の編集、フィルターなしで
フィルター付きの編集が拒否する衣装変更も、ここでは特別扱いではなく、ふつうの指示として扱われます。設定する成人フラグも、リクエストが振り分けられる別のエンドポイントもありません。指示の中の言い回しは、書いたとおりに渡されます。
部屋を描き直さずに看板の文字を書き換える
Qwen Image 系の文字の扱いを受け継いでいるので、すでに画像の中にある文言を変えられます。ドアノブの札、メニューボード、ボトルのラベルなどです。いまの文字列と変えたい文字列を引用し、ポーズ、フレーミング、色調は変えないと明記してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 権利を保有している画像への、公開された直接ダウンロード可能なリンクです。ビューアのページや短命な署名付き URL は失敗します。 1 文字以上 |
prompt | はい | 編集の両側を運ぶ 1 本の指示です。変更点を名指しし、続けて同一のまま残らなければならないポーズ、画面の取り方、照明、グレードを名指ししてください。 1 文字以上 |
seed | いいえ | 同じ画像と同じ指示に同じ seed を渡すと、2 回の編集で乱数がそろい、違いは書き換えた箇所だけになります。比較のための値であって、同じ編集がそのまま返る約束ではありません。 |
料金
$0.038 / 枚
ユースケース
手元の画像を仕上げる
既存の写真はそのままに、1 か所だけを変えたいときに使います。写真を image_url で送り、変える点と残す要素、つまりポーズ、フレーミング、光、色調を書き、結果を元画像と見比べます。
ほかのエディターが断る指示
フィルターのかかった編集 API が突き返す、大胆な衣装の指示も、ここではふつうの編集として動きます。リクエストは何も変わりません。同じフィールド名、同じタスクの流れ、同じ非同期のポーリングで結果を受け取ります。
承認済みの 1 枚で衣装を替える
ポーズと光がうまくいったポートレートがすでにあるなら、場面を作り直さずに、服をイブニングウェアや、より大胆な装いに替えます。顔も部屋も色調も残るので、セットのまとまりも崩れません。
すでに費用をかけた写真で文言のバリエーションを作る
看板、札、ラベルの文字だけを変え、写真はまったく同じに保ちます。言語ごと、キャンペーンのコピーごとに場面全体を作り直すより安く、ずっと一貫します。
プロンプトガイドと実践のヒント
元画像は取得できる場所に置く
image_url は、公開されていて直接ダウンロードできるリンクにしてください。ビューアーのページや、タスクが動く前に期限が切れる署名付き URL は使えません。構図と品質の上限は、元画像が決めます。
編集の両側を書いた指示を 1 つ書く
変えるものと、まったく同じに残すものを、それぞれ 1 文で書きます。このエンドポイントの編集は、次の指示から作りました。「Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.」
付属の例を作り替える
公開している例から始め、image_url には公開されてアクセスできる URL を入れます。被写体と演出を入れ替えつつ、このモードの入力の決まりはそのまま保ちます。
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
このエンドポイントで見せている編集の元になった、そのままの指示です。服を替え、ドアノブの札の文字も変えつつ、ポーズ、フレーミング、光、色調は変えないと明記しています。元画像はご自身で用意してください。ここの image_url は仮のもので、ホストされたサンプルではありません。
反復する前に結果を確かめる
確実なのは、1 回の呼び出しで変えるのを 1 つにし、ポーズ、フレーミング、光、色調といった残す要素を明記するやり方です。衣装の変更と文字の変更を同じ指示で頼むと、たいていどちらかがずれます。狙いを絞った 1 回の編集なら人物はよく保たれますが、長く編集を重ねると崩れていくので、前の結果からではなく元画像から編集し直してください。強度の調整はありません。やりすぎたときに直すのは数字ではなく、より具体的な文章です。
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-spicy-edit/edit",
"input": {
"image_url": "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 リファレンスを参照してください。
