はじめに
Prefect Pony XL LoRA テキストから画像 は、タグのプロンプトから、自前の LoRA ファイルを最大 3 つ読み込んだアニメまたはイラストの画像を 1 枚描きます。Pony Diffusion の系譜に連なるコミュニティ製 SDXL チェックポイントのマージモデル Prefect Pony XL を使い、LoRA の枠、guidance の調整、SDXL ネイティブの 9 種類のアスペクト比を加えています。プラットフォームはプロンプト、ウェイト、画像のいずれにもコンテンツフィルターを加えません。
関連ページ
LoRA の枠なしの Prefect Pony XL は、別のページがあります。Prefect Pony XL
主な機能とハイライト
直接リンクで使える Pony 系 LoRA
Pony のエコシステムには、スタイルとキャラクターの LoRA が豊富にそろっています。.safetensors ファイルへの直接リンクと scale を渡すだけで、事前に当社へアップロードするものはなく、ファイルが審査されることもありません。
同時に 3 つ
1 リクエストに LoRA を最大 3 つまで、それぞれ個別の scale で使えます。当社のテストでは、0.8、0.5、0.3 で重ねた 3 つが一緒に読み込まれ、主役のスタイルもはっきり読み取れました。
SDXL ネイティブの形
9 種類のアスペクト比は、それぞれ 1024 x 1024 から 1536 x 640 までの SDXL ネイティブサイズに対応しています。当社のテストでは、どれも指定したとおりのサイズで返りました。
ウェイトの有無にかかわらず規制なし
当社で最も強いレベルのテストが、LoRA なしでも読み込んだ状態でも、1 回目から書いたとおりに生成されました。コンテンツフラグも、結果の二次審査もありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | カンマ区切りのタグがいちばんうまくいきます。スコアタグ、ソースとレーティングのタグ、人数、被写体の順に書きます。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 21:9 から 9:21 まで SDXL ネイティブの 9 種類の形で、既定は 1:1（1024 x 1024）です。比率が変えるのは形で、料金は変わりません。 |
loras | いいえ | Pony 系の SDXL チェックポイント向けに学習した {path, scale} を最大 3 つ。scale は 0 から 4 で、1 が中立、0.7 から 1 が始めやすい値です。 デフォルト値: |
guidance_scale | いいえ | 画像がプロンプトにどこまで従うかを 1 から 20 で指定します。既定は 3.5 です。 |
output_format | いいえ | 既定は JPEG で、PNG か WebP も選べます。形式によって料金は変わりません。 |
seed | いいえ | LoRA の scale やタグを 1 つずつ変えていく間、画像のセットを比べられる状態に保ちます。毎回まったく同じピクセルになることを保証するものではありません。 |
料金
$0.024 / 枚
1 枚ごとに課金されます。アスペクト比、出力形式、LoRA の読み込みによって料金は変わりません。
ユースケース
セット全体に共通のハウススタイル
スタイル LoRA を読み込み、トリガーワードを先頭に置いたまま、プロンプトのリストを流します。セット内のどの画像も同じルックになります。
一貫したキャラクター
キャラクター LoRA と seed を固定し、プロンプトごとに衣装、場所、光だけを変えます。
プラットフォーム向けの規制なしのアニメ
利用者が求める LoRA を読み込み、絵をそのままタグで書きます。入力側も出力側もフィルターはかかりません。
プロンプトガイドと実践のヒント
スコアタグを先頭に
score_9, score_8_up, score_7_up で始め、続けて source_anime のようなソースタグ、レーティングタグ、人数（1girl、1boy）、被写体の順に書きます。各 LoRA のトリガーワードは、いちばん先頭に置いてください。
年齢を書く
すべてのキャラクターが成人であることを明記します（mature female、adult man、30 years old）。このページの作例はすべてそうしています。
LoRA なしと比べる
同じプロンプトと seed で、LoRA なしでも生成します。2 枚が同一なら、そのファイルは別のベースモデル向けに学習したものです。そうした LoRA はエラーなく読み込まれ、何もしません。
Guidance は 3.5 から 7 あたり
既定の 3.5 はバランスの取れた値です。当社のテストでは、7 でコントラストと彩度が上がり、12 で色が飛び、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": "prefect/pony-xl-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"
}
}'
# 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 リファレンスを参照してください。
