はじめに
MiniMax H3 Image LoRA 画像編集 は、参照画像に写った人や物を、新しいシーン、衣装、ポーズ、スタイルで描き直します。オープンウェイト版の MiniMax H3 に自前の LoRA ファイルを最大 3 つ読み込めます。画像を 1〜9 枚送って Picture 1、Picture 2 のように呼び分けると、1k か 2k の画像が 1 枚、1 枚目の参照画像の形か 15 種類のアスペクト比のいずれかで返ります。
手元の素材からモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章で書いた説明 | MiniMax H3 Image LoRA テキストから画像 |
| 手を加えたい画像 1〜9 枚 | MiniMax H3 Image LoRA 画像編集 |
| 動かしたい静止画 | MiniMax H3 LoRA 画像から動画 |
主な機能とハイライト
参照画像から引き継ぐ同一性
顔、髪型、特徴的な服のディテールは引き継がれ、それ以外はすべて変わります。当社のテストでは、ポートレート 1 枚をまったく別の舞台とポーズに置いても、顔と髪ははっきり同じ人物だと分かるままでした。
番号付きのソースを最大 9 枚
人物、衣装、小物、場所を別々の画像から 1 リクエストで組み合わせられます。プロンプトで番号を振れば、どの画像が何を担うかがモデルに伝わります。
カスタムウェイトでも規制なしの編集
参照は、何が写っていてもそのまま受け付けられます。対応する LoRA と当社の最も強いコンテンツのプロンプトを使うと、編集は書いたとおりに描かれました。審査もフィルターも一切ありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 各画像が何を担うかを書き、それから新しいシーン、衣装、スタイルを書きます。同一性は参照画像から来るので、顔を説明する必要はありません。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 1〜9 枚の参照画像で、プロンプトでは <Picture 1>、<Picture 2> のように呼びます。アスペクト比を選ばない限り、出力の形も 1 枚目で決まります。 1 件以上 · 9 件以内 |
aspect_ratio | いいえ | 未指定なら 1 枚目の参照画像に合わせます。15 種類から選ぶこともできます。 |
resolution | いいえ | 1k は約 100 万画素、2k は約 400 万画素です。 |
loras | いいえ | MiniMax H3 向けに学習した {path, scale} を最大 3 つ。scale は 0〜4 です。 デフォルト値: |
output_format | いいえ | 既定は JPEG で、必要なら PNG か WebP も選べます。 |
seed | いいえ | 指示を変えながら編集結果を比べやすくします。 |
料金
解像度に応じて 1 枚ごとに課金され、2 枚目以降の参照画像 1 枚ごとに少額が加わります。LoRA の追加料金はかかりません。
| 仕様 | 料金 |
|---|---|
| $0.054 / 枚 |
| $0.126 / 枚 |
ユースケース
同じ人物を新しいシーンに
きれいなポートレートが 1 枚あれば、バルコニーにも、ホテルの部屋にも、ステージにも人物を置けます。光と服はプロンプトで変え、顔は画像から引き継ぎます。
衣装や商品の差し替え
人物を Picture 1、服や商品を Picture 2 として送り、その人物が着ている、または持っている姿を指示します。カタログ制作や、キャラクターの衣装を一貫させたいときに役立ちます。
LoRA でスタイルを変える
アニメ、フィルムストック、VHS の LoRA を読み込み、同じ画像をそのスタイルで描くよう指示します。構図と人物はそのままに、表現媒体が変わります。
プロンプトガイドと実践のヒント
画像の対応を書いてから、変更を書く
参照画像ごとに短い一文を書き、それから変えたい点だけを書きます。顔をもう一度説明すると、参照画像の助けになるどころか、ぶつかりがちです。
参照画像は少なく、鮮明に
役割のはっきりした 2〜3 枚のほうが、重なり合う 9 枚よりたいてい良い結果になり、2 枚目以降は 1 枚ごとに料金も加わります。大事な部分が画面いっぱいになるよう、参照画像をトリミングしておいてください。
同一性が大事なら強度は控えめに
強いスタイル LoRA を高い強度で使うと、顔がその学習データのほうへ引っ張られることがあります。スタイル LoRA は 0.7〜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": "minimax/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 リファレンスを参照してください。
