はじめに
Krea 3 画像編集は、平易な指示で 1 〜 8 枚の元画像を変更または組み合わせます。Krea 3 は編集を第一に作られたので、何を変えて何を残すかを書き、元画像は image 1、image 2 のように呼んでください。出力の形状は自分で選びます。結果はどれも約 1 MP です。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章での説明 | Krea 3 テキストから画像 |
| 変更または組み合わせたい写真 1 〜 8 枚 | Krea 3 画像編集 |
主な機能とハイライト
人物、服、場所を組み合わせる
1 回のリクエストで最大 8 枚の元画像を使えます。例では image 1 の女性が、image 2 のペイズリー柄のドレスを着て、峡谷のデッキに立ち、顔と髪を保っています。
番号で元画像を指定する
「image 2 の人物」と書くと、2 番目にアップロードした画像が選ばれます。当社の確認では、image 1 に女性、image 2 に男性を置いたとき、描かれたのは男性だけでした。
大きな変更でも同一性を保つ
オフィスのブレザー姿の女性を、同じ顔、三つ編み、構図のまま、羽目板張りの書斎の 1970 年代風のポートレートにしました。
ファッション程度のコンテンツのみ
リクエストと元画像は審査されます。服や場面の変更は通りました。服を脱がせるリクエストは拒否され、課金されませんでした。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 何を変えるかを書き、次に何を保つかを書きます。元画像はアップロードした順に image 1、image 2 と呼んでください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 1 〜 8 枚。プロンプトで指定する順に並べてください。 1 件以上 · 8 件以内 |
aspect_ratio | いいえ | 出力の形状：1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9、21:9 のいずれか。既定は 1:1。 |
quality | いいえ | high（既定）は細部を重視し、fast は早く返ります。料金は同じです。 |
enable_thinking | いいえ | 描画の前にプロンプトをより長く計画します。当社のテストでは約 2 倍の時間がかかりました。 デフォルト値: |
negative_prompt | いいえ | 除外したいものを最大 1,024 文字まで。高品質版でのみ使われます。 1024 文字以内 |
output_format | いいえ | PNG（既定）か JPEG。料金への影響はありません。 |
seed | いいえ | 任意で、0 〜 2147483647。seed を再利用すると以前の画像に近づきますが、一致する保証はありません。 |
料金
$0.072 / 枚
1 枚ごとに課金されます。出力の料金に、元画像 1 枚ごとに同額が加算されます。品質版、思考、アスペクト比では料金は変わりません。拒否されたリクエストには課金されません。
ユースケース
仮想試着とスタイリング
人物の写真と服の商品写真を組み合わせると、その服を着た人物のスタイリング画像になります。
再構成と時代の雰囲気
人物が誰であるかを保ったまま、別の場所、時代、光に移します。
プロンプトガイドと実践のヒント
変更点から書く
何を変えるかを先頭に書き、次に何を保つかを一文で添えてください。複数の元画像があるときは、それぞれに名前を付けます。「image 1 の女性」「image 2 のドレス」のように。
出力の形状を選ぶ
結果は元画像の形状ではなく、選んだアスペクト比で作られます。意図しないトリミングを避けるには、主要な写真の比率に合わせてください。
元画像の枚数に注意する
元画像は 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": "krea/3/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high"
}
}'
# 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 リファレンスを参照してください。
