はじめに
P-H3-Image のテキストから画像は、シーンの説明から静止画を 1 枚生成します。Pruna AI は MiniMax H3 を画像生成と編集向けに調整し、2026 年 11 月 3 日にオープンウェイトを公開しました。
主な機能とハイライト
15 種類のアスペクト比とは別に、1k、1.5k、2k、3k、4k を選べます。当社のテストでは、4k・16:9 の設定で 5472 x 3072 ピクセルを出力しました。JPEG、PNG、WebP で受け取れます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | シーンの説明は必須で、既定の文章はありません。形容詞を長く並べず、服装、舞台、光を簡潔に記述してください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 15 種類の形から選べます：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。省略時は 1:1 で生成します。 |
resolution | いいえ | 1k（既定、約 1 MP）、1.5k（約 2.4 MP）、2k（約 4 MP）、3k（約 9.4 MP）、4k（約 16.8 MP）から選びます。この項目で課金対象のサイズの段階が決まります。 |
output_format | いいえ | ファイルのエンコードは既定で jpeg です。ほかに png と webp を指定できます。 |
seed | いいえ | 乱数の生成元を指定する任意項目で、必須の固定値はありません。同じ値を使いながら設定を 1 つ変えると、条件をそろえて比較できますが、同一の出力は保証されません。 |
料金
生成画像は、選択した 1k、1.5k、2k、3k、4k の段階に応じて 1 枚ごとに課金されます。比率と形式の追加料金はありません。編集モードでは 2 枚目以降の入力ごとに少額が加わります。失敗したリクエストには料金がかかりません。
| 仕様 | 料金 |
|---|---|
| $0.024 / 枚 |
| $0.036 / 枚 |
| $0.048 / 枚 |
| $0.096 / 枚 |
| $0.144 / 枚 |
ユースケース
シーンの説明から、エディトリアル風ポートレート、ダイナーの映画スチル風画像、短いネオン看板などを作れます。既存の画像を変更する場合は、画像編集 を選んでください。
プロンプトガイドと実践のヒント
被写体、服装、場所、光源を指定します。Pruna AI によると、引用符で囲んだ短い語句は描けることがありますが、長文や小さな文字は意味のない文字になる場合があります。seed を保って要素を 1 つ変えると比較しやすくなりますが、出力を固定する設定ではありません。当社のテストでは高解像度ほど時間がかかり、4k の生成でモデル処理時間が 241 秒に達した例がありました。
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 リファレンスを参照してください。
