はじめに
P-H3-Image LoRA のテキストから画像は、文章から静止画を生成する際に MiniMax H3 用 LoRA ウェイトを受け付けます。ファイルを追加しないエンドポイントと同じ P-H3-Image を基盤に使います。
主な機能とハイライト
ファイルを最大 3 つ追加し、各 scale を 0〜4 で指定できます。当社のテストでは、同じ seed で vh5tape を強度 1 にすると画像が変わりましたが、リアル系ファイルの 0.8 では見た目の差がわずかでした。サイズは 4k までの 5 段階から引き続き選べます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須項目で、既定の文言はありません。LoRA の学習時のトリガーワードに続けて、作りたいシーンを簡潔に説明してください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | LoRA を使う生成では、対応する 15 種類の比率から選びます。既定は 1:1 です。 |
resolution | いいえ | サイズの初期値は 1k（約 1 MP）です。1.5k（約 2.4 MP）、2k（約 4 MP）、3k（約 9.4 MP）、4k（約 16.8 MP）も選べます。 |
loras | いいえ | MiniMax H3 向けに学習したファイルを、任意のリストに最大 3 件の {path, scale} として指定します。比較用にはファイルを追加しません。 デフォルト値: |
output_format | いいえ | 生成するファイルには jpeg、png、webp を選べます。省略時は jpeg です。 |
seed | いいえ | LoRA の変更を 1 つ比較するときは、seed を再利用して乱数の生成元をそろえます。任意項目で、必須の既定値はありません。 |
料金
選択したサイズの段階の 1 枚あたり料金に、少額の LoRA 固定追加料金が加わります。ファイル数が 0〜3 個のどれでも料金は同じです。比率と形式の加算はなく、編集では 2 枚目以降の入力ごとに少額が加わります。失敗したリクエストは課金されませんが、無効な LoRA リンクが通知なしでスキップされた場合は画像が生成され、課金されます。
| 仕様 | 料金 |
|---|---|
| $0.042 / 枚 |
| $0.054 / 枚 |
| $0.066 / 枚 |
| $0.114 / 枚 |
| $0.162 / 枚 |
ユースケース
VHS ファイルでモーテルのシーンを、Studio1939 style でクラブのトリオを試してください。元の写真を変換する場合は、LoRA 画像編集 を開きます。
プロンプトガイドと実践のヒント
まず LoRA なしの比較用画像を 1k で作り、同じ prompt と seed でファイルを有効にして再実行します。実際に .safetensors をダウンロードする URL と、そのファイルのトリガーワードを使ってください。当社のテストでは、リポジトリページや存在しないファイルの URL で 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/text-to-image",
"input": {
"aspect_ratio": "1:1",
"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 リファレンスを参照してください。
