はじめに
P-H3-Image LoRA の画像編集は、先頭に渡した画像を変換しながら、H3 向けに学習したファイルを適用します。さらに 8 枚の参照画像を加え、それぞれから取り入れる要素を指定できます。
主な機能とハイライト
カートゥーンのテストでは、Studio1939 style を強度 1 で使い、ポーズ、ドレス、マイクを失わずに歌手を描き直せました。同じ LoRA 項目に最大 3 件を指定でき、各ファイルの scale を個別に 0〜4 で調整できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 変換の指示は必須で、学習時のトリガーワードとともに記述します。既定の指示はありません。 1 文字以上 · 5000 文字以内 |
image_urls | はい | URL を順番に 1〜9 件指定してください。編集にはこのリストが必要で、既定の画像はありません。 1 件以上 · 9 件以内 |
aspect_ratio | いいえ | 省略時は最初の元画像で形が決まります。1:1、9:16、16:9、1:3、3:1、9:21、21:9 を含む、対応する 15 種類の比率のいずれかで上書きできます。 |
resolution | いいえ | LoRA を使う編集の既定サイズは 1k（約 1 MP）です。より大きい 1.5k（約 2.4 MP）、2k（約 4 MP）、3k（約 9.4 MP）、4k（約 16.8 MP）も選べ、選択した段階によって料金が変わります。 |
loras | いいえ | MiniMax H3 向けに学習したファイルを {path, scale} で最大 3 つ追加するか、比較用には省略します。scale は 0〜4、既定は 1 です。 デフォルト値: |
output_format | いいえ | 結果は既定で jpeg を使い、png または webp に変更できます。エンコードを変えても画像の料金は変わりません。 |
seed | いいえ | 乱数の生成元を指定する任意項目です。省略時に固定の seed は不要です。 |
料金
LoRA を使う編集では、解像度に応じた画像ごとの料金に、ファイル数にかかわらず少額の固定料金が加わります。2 枚目以降の参照画像にも各少額が加算されます。アスペクト比と形式は料金に影響しません。失敗したリクエストは課金対象外です。無効な LoRA リンクはスキップされる場合があり、その場合も画像が生成されて課金されます。
| 仕様 | 料金 |
|---|---|
| $0.048 / 枚 |
| $0.066 / 枚 |
| $0.084 / 枚 |
| $0.156 / 枚 |
| $0.228 / 枚 |
ユースケース
ステージ写真を昔のカートゥーンに変えたり、VHS 表現でデニムジャケット姿のリビングのシーンを指定したりできます。学習時のトリガーワードを編集指示に加え、元画像を <Picture 1> として指定します。
プロンプトガイドと実践のヒント
ファイルの効果を見るには、入力画像、prompt、seed を変えずに、LoRA なしの比較用画像と有効にした結果を比べます。乱数の生成元は共有できますが、同じ画素になる保証はありません。path がウェイトファイルの直接リンクかを確認してください。誤ったリンクではスタイルが適用されなくても、編集は成功して課金される場合があります。loras を空にしても、LoRA エンドポイントの追加料金はかかります。
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-lora/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 リファレンスを参照してください。
