はじめに
最初の URL が編集する画像です。続く URL の画像は、指示の中で <Picture 2>、<Picture 3> のように呼ぶ参照素材となります。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| モデルと出力 | MiniMax H3-Image の公開ウェイトで、text-to-image と画像編集による静止画です。 |
| prompt の文字数 | 両エンドポイントで必須、最大 5,000 文字です。 |
| 解像度段階 | 1k 約 1 MP(既定)、1.5k 約 2.4 MP、2k 約 4 MP、3k 約 9.4 MP、4k 約 16.8 MP です。 |
| キャンバス比率 | 15 種類:1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、2:1、1:2、3:1、1:3、21:9、9:21 です。 |
| 形の既定動作 | 文章からの生成は 1:1、編集は |
| 編集画像の数 | 元画像と最大 8 枚の参照で、合計 1–9 枚です。 |
| 画像の参照記法 | 元画像は <Picture 1>、追加参照は <Picture 2> 以降で指定します。 |
| seed の利用 | 任意です。画素の一致を保証せず、変更 1 つの比較に使えます。 |
| ファイル形式 | jpeg(既定)、png、webp。形式で料金は変わりません。 |
| 画像寸法の記録 | 1k・3:4 は 896 x 1184、1.5k・9:16 は 1152 x 2048、2k・3:2 は 2496 x 1664、3k・1:1 は 3072 x 3072、4k・16:9 は 5472 x 3072 です。 |
| モデル処理の実測 | 11 月 11 日の 1k は午前 20–45 秒、夜 3–6 秒、夜の 4k は 36 秒でした。待機と転送は含みません。 |
| 課金の仕組み | 完成画像ごとに解像度別の料金がかかります。編集は元画像以降の参照に追加料金があり、失敗時は無料です。 |
主な機能とハイライト
街の輪郭を背にした青いプール光
1.5k、3:4、seed 7 の屋上プールでは、夜の水から出る男性を都市の明かりと青い光が照らします。大きな正方形の朝食例と並び、中間段階での肖像の例になっています。
中大サイズで描くテーブル
朝食のサンプルは seed 7 で、パン、イチジク、蜂蜜、リネンを 3072 x 3072 に描きました。
海岸の場面に自転車の乗り手を加える
合成では <Picture 1> の道と淡い青のクーペを残し、<Picture 2> の人物と自転車を横に置きました。
曇り空を秋の光へ
元画像 1 枚が、舞うオレンジ色の葉と霧の川を伴う秋の橋へ変わりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 5,000 文字以内の編集説明が必須です。元画像を <Picture 1>、続く参照を で示してください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 1〜9 個の URL を順に指定し、先頭の画像を編集します。既定の元画像はありません。 1 件以上 · 9 件以内 |
aspect_ratio | いいえ | 1:1、1:2、2:1、1:3、3:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、9:21、21:9 から、使用する比率を選べます。未指定なら最初の入力画像の比率に従い、比率指定による追加料金はありません。 |
resolution | いいえ | 編集の出力は既定で 1k です。1.5k・2k・3k・4k にも対応し、上の段階ほど料金が高くなります。 |
output_format | いいえ | 編集画像は jpeg(既定)、png、webp で保存できます。いずれも選んだサイズ段階の料金は共通です。 |
seed | いいえ | 編集の比較用に乱数の生成元を任意指定できます。固定しない場合は未設定にします。 |
料金
完了した編集には、最初の入力を含む選択サイズの料金がかかり、2 枚目以降には個別に少額が加算されます。大きな段階ほど料金は上がり、失敗したリクエストは無料です。
| 仕様 | 料金 |
|---|---|
| $0.024 / 枚 |
| $0.042 / 枚 |
| $0.06 / 枚 |
| $0.132 / 枚 |
| $0.204 / 枚 |
ユースケース
雰囲気を定めた夜の肖像
人物、動作、光源を中心に場面を構成します。屋上プールの例では 1.5k、3:4、seed 7 で、都市の明かりと青いプールの光を背にした男性が返りました。
大きなサイズのテーブル配置
物と配置を説明してから段階を選びます。3k の正方形の朝食は 3072 x 3072 で、パン、イチジク、蜂蜜、リネンを真上から捉えました。
役割を分けた元画像の合成
場所と加える人物に異なる画像番号を与えます。海岸の編集では道と淡い青のクーペが残り、別参照の自転車と乗り手が横に現れました。
人物を残して季節を変更
残す細部を明記し、新しい季節や光を依頼します。橋の編集は人物と自転車を保ち、秋の葉、金色の光、川の霧を加えました。
短い指定文字の看板
短い看板やラベルを引用し、場面内の場所を示します。同一 prompt の比較は木製看板に HOT SOUP 3 FRANCS を正確に描きました。長文は引き続き慎重な確認が必要です。
プロンプトガイドと実践のヒント
場面か元画像から始めます
文章で作るなら text-to-image、写真を修正するなら画像編集を選びます。編集は使用権のある成人の写真を使い、なりすましを避けます。
構図と参照の役割を記述
場所、被写体、服装、光、カメラの視点をつながった英語で書きます。編集では元画像を <Picture 1> と呼び、後の参照にも番号と役割を与えます。
形と段階、形式を決めます
1k–4k から解像度を選び、生成では比率も指定します。編集で比率を省くと元画像に従います。既定は JPEG で、PNG と WebP も使えます。
seed で変更を比較します
seed などの設定を固定し、指示を 1 つ変えます。結果の細部を説明と照合してください。固定 seed は比較を助けますが、同一結果を約束しません。
番号付き参照で元画像を編集
MiniMax H3-Image Open Weights の編集は、元写真を基に文章の変更指示に従います。image_urls の先頭に元画像を置き、人物、物、場面の細部を追加する必要がある場合に参照を足します。合計 9 枚、元画像と最大 8 枚の参照を使えます。
海岸の合成は淡い青のクーペのある道路に人物と自転車を加えました。秋の編集は元画像 1 枚を使い、人物を残して周囲を変えました。同じ元画像・参照設定で異なる依頼ができます。
編集用パラメータ
| パラメータ | 編集での意味 | 既定・制約 |
|---|---|---|
image_urls | 順序付きの元画像と参照 URL | 必須、合計 1–9 枚です |
prompt | 変更、役割、残す部分の指示 | 必須、最大 5,000 文字です |
aspect_ratio | 対応する形から選びます | 省略すると元画像に従います |
resolution | 1k, 1.5k, 2k, 3k, 4k | 1k。上の段階ほど高額です |
output_format | jpeg, png, webp | jpeg。形式による追加料金はありません |
seed | 比較用の任意の乱数源 | 同一結果は保証しません |
比率は 1:1、1:2、2:1、1:3、3:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、9:21、21:9 です。元の形を基準にするなら aspect_ratio を省き、別の画面が必要なら指定します。解像度は形とは独立に選びます。
写真ごとに役割を決める
元は <Picture 1>、次の入力は <Picture 2> と順に続きます。prompt のトークン番号と URL の一覧を一致させます。漠然と「参照」と呼ぶだけでは役割が不明確です。
合成なら <Picture 1> の海岸道路とクーペを残し、<Picture 2> の 30 代女性と自転車を駐車した車の横に加え、午後の光を合わせて顔とデニムジャケットを保つ、と分けて伝えられます。場所、加える被写体、保持目標にそれぞれ文節を与えます。
使用権のある写真だけを使い、入力人物は成人とし、なりすましを避けてください。ここの例は 30 代以上を描いています。
変更と保持の両方を書く
季節や場所を変える場合は、人物、髪型、服装、自転車など残すものを示してから新しい周囲と光を書きます。石橋の人物を残し、秋の葉、金色の朝日、霧の川を求めるように焦点を絞れます。出力後に人物と重要な物を確認します。
別の参照が物を供給するなら、番号と物の名前、配置先を示します。参照枠を埋める必要はありません。指示で特定できる役割がある画像を選びます。
seed で変更を 1 つずつ比較
seed、入力順、比率、段階を保ち、季節や光など 1 節だけ変更します。何を変えたか分かるよう、入力一覧と文章を結果とともに保存します。seed は比較用の乱数源を固定しますが、画素の一致や全細部の保持は保証しません。
編集テストで確認したこと
海岸の 2 枚編集では元の道路を残し、淡い青のクーペの横に人物と自転車を置けました。1 枚の秋の例では人物と自転車が残り、オレンジ色の葉、金色の光、川霧が加わりました。服装と場所のテストでも顔を保ちました。個別の観察なので、新しい結果は各元画像と比較してください。
NSFW の記録
11 月 11 日夜の編集確認では拒否はなく、毎回画像が返り課金されました。指示どおりは Mild 3/3、Moderate 2/3、Strong 2/3、Very strong 0/3、Maximum 6/6 です。それ以外は表現が抑えられました。画像を受け取ることと全指示の一致は別で、後のすべての編集を予測する記録ではありません。
編集料金
選んだ出力段階が画像単価を決め、元画像を含みます。その後の画像ごとに少額料金を加えます。5 段階はそれぞれ異なる単価で大きいほど上がり、JPEG、PNG、WebP では変わりません。失敗は無料です。合成前に モデルページの最新価格 と入力数を確認します。
制約と代替案
ネガティブプロンプト、ガイダンス、サンプリングステップの欄はありません。最大 9 枚で、出力は動画や音声でなく静止画です。編集完了は顔、物の形、指定文字の完全一致を保証しません。説明で挙げた細部を調べます。
元画像なしなら 文章から画像を生成、最大 3 つのスタイルウェイトを追加するなら LoRA 版 を使います。10–16 枚必要なら MiniMax H3-Image を検討します。こちらは image 1、image 2 とアップロード順で呼び、seed はありません。両版の出力一致は未確認です。P-H3-Image は別モデルなので、prompt と seed が同じでも互換の結果にはなりません。
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-open/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 リファレンスを参照してください。

























