はじめに
P-H3-Image の画像編集は、最初の画像を元画像とし、追加で最大 8 枚の参照画像を受け付けます。残す要素と差し替える要素を文章で指示します。
主な機能とハイライト
元画像は <Picture 1>、次の入力は <Picture 2> と指定します。既定の出力の形は 1 枚目に合わせ、aspect_ratio を選ぶと上書きできます。編集でも 5 段階すべての解像度を使えます。当社のテストでは、4k の編集で 3360 x 5024 ピクセルが返った例がありました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 編集指示は必須で、既定の指示はありません。変える点と残す点を示し、複数の元画像を組み合わせる場合は画像番号を指定してください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 順序付きの画像 URL リストは必須で、1〜9 枚を指定します。既定の元画像はありません。 1 件以上 · 9 件以内 |
aspect_ratio | いいえ | 任意項目で、省略すると 1 枚目の画像の比率を引き継ぎます。1:3 から 3:1 まで、9:21 や 21:9 を含む 15 種類の対応比率で上書きできます。 |
resolution | いいえ | 編集の既定は 1k、約 1 メガピクセルです。1.5k（約 2.4 MP）、2k（約 4 MP）、3k（約 9.4 MP）、4k（約 16.8 MP）も選べ、段階を変えると画像の料金が変わります。 |
output_format | いいえ | png または webp を指定しなければ、編集結果は jpeg で保存されます。3 種類のエンコードの料金は共通です。 |
seed | いいえ | 編集を比較するときに乱数の生成元を指定できますが、既定で必須となる値はありません。値を固定して指示を 1 つずつ変えてください。 |
料金
編集結果は、1k、1.5k、2k、3k、4k の段階に応じて 1 枚ごとに課金されます。2 枚目以降の入力画像にはそれぞれ少額が加算され、出力の比率とエンコードには加算されません。失敗したリクエストは課金対象外です。
| 仕様 | 料金 |
|---|---|
| $0.03 / 枚 |
| $0.048 / 枚 |
| $0.066 / 枚 |
| $0.138 / 枚 |
| $0.21 / 枚 |
ユースケース
ポートレート 1 枚から服装と舞台を海辺のシーンに変えたり、ステージ写真と別の出演者を組み合わせたりできます。当社の 1 枚入力と 2 枚入力のテストでは、シーンが変わっても指定した人物の特徴が保たれました。
プロンプトガイドと実践のヒント
残したいシーンを先頭に置き、各番号の画像からどの特徴を取り入れるかを伝えます。当社のテストでは、順番を逆にすると、もう一方のシーンに近い結果になりました。2 枚目以降の参照画像には 1 枚ごとに少額が加算されます。Pruna AI によると、低い解像度では細部の乱れが目立ちやすくなります。
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": "pruna-ai/p-h3-image/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 リファレンスを参照してください。
