本文へスキップ

Pony XL LoRA API ガイド:規制なしアニメ系モデルで自分の LoRA を動かす

自分の Pony XL LoRA を API で実行。トリガーワード、強度、guidance 1〜20、3つの重ね掛け、ベース違いで無反応になる罠、サイズまでテスト済み。

執筆
Lydia
公開
読了時間
約 17 分
更新
1920年代の舞踏室でタンゴを踊る大人のカップル。金色のアール・デコ調アニメスタイルで描かれている

Prefect Pony XL LoRA は、規制なしのアニメ系チェックポイントに自前の Pony LoRA を最大3つ読み込み、guidance を 1 から 20 まで調整できるモデルです。 2026年10月5日の当社テストでは、モデル処理時間は1枚あたり 1.6〜23.8 秒、47回の実行で中央値は 12.3 秒でした。当社で最も強いコンテンツのプローブは、LoRA を読み込んだ場合も読み込まない場合も、書いたとおりに生成されました。始める前に知っておきたい罠が一つあります。別のベースモデル用に学習された LoRA は、エラーなしで読み込まれ、何も変えないのです。

Prefect Pony XL LoRA は Prefect Pony XL を動かします。SDXL をバックボーンとし、Pony Diffusion V6 の系譜に連なるコミュニティ製マージで、アニメとイラスト向けに調整されています。Civitai のページではアップロード者が Goofy_Ai、最新バージョンの v6 は2025年8月14日公開とされています。ただ、当社のエンドポイントがどのバージョンを動かしているかは提供元が明かしていないため、こちらも言及しません。このガイドでは、実際に測定した内容(トリガーワード、強度、guidance、重ね掛け、サイズ、失敗パターン)を扱います。以下のプロンプトはすべて、服を着た大人の日常的なシーンです。操作を学ぶにはそれで十分です。

ひと目でわかる要点

質問答え(2026年10月5日テスト)
モデルPrefect Pony XL(アニメ・イラスト向けマージ、SDXL バックボーン)
API モデル名prefect/pony-xl-lora/text-to-image
LoRA フィールドloras:最大3件、各 {path, scale}。4件目は拒否される
pathPony 系 SDXL モデル向けに学習された .safetensors ファイルへの、公開された直接の HTTPS リンク
scale0〜4。提供元は 0.7〜1.0 あたりから始めることを推奨
Guidanceguidance_scale 1〜20、既定は 3.5
サイズSDXL ネイティブサイズの9種類のアスペクト比。640×1536 から 1536×640 まで
テストでの速度モデル処理時間 1.6〜23.8 秒、中央値 12.3 秒(47回の実行)
非対応画像入力、ネガティブプロンプト、ステップ数
課金1枚あたり均一。サイズ、LoRA の数、出力形式では変わらない
黄色いワンピース水着にサングラス姿の女性がプールの縁に座っている。フラットなベクター調で描かれている

Prefect Pony XL LoRA、テキストから画像、1:1、seed 33、Flat Vector LoRA を強度 1 で使用。プロンプトは下に掲載しています。

Pony LoRA とは何か

Pony LoRA とは、Pony 系の SDXL モデル向けに学習されたアダプターファイルです。このエンドポイントについての提供元の指針は明快で、Pony 系 SDXL モデル向けに学習された LoRA だけを使うこと、というものです。当社は Hugging Face の EarthnDusk リポジトリにある公開アダプター3つに、ピクセルアート系の1つを加えて使いました。

  • Flat Vector、トリガーは vztdzsxx。すっきりしたフラットカラーのベクターイラストになりました。
  • InkPunk、トリガーは end_inkpunk_style。墨の濃淡やはねを活かした線画になりました。
  • Art Deco、トリガーは end_artdeco_inspo。金色の幾何学模様が映える1920年代の装飾になりました。

ほかの Pony LoRA を選ぶ前のチェックリスト:

  1. ベースモデル: カードに Pony または Pony XL と書かれていること。SD 1.5、Illustrious、Z-Image、FLUX ではないこと。
  2. リンクできるファイル: リポジトリに .safetensors ファイルがあり、resolve/main/ のリンクを組み立てられること。
  3. 公開アクセス: ログインなしでリポジトリを開けること。ゲート付きのものは HTTP 401 のメッセージで失敗します。
  4. トリガーワード: カードにトリガーワードが明記されているか、不要と書かれていること。そのままコピーしてください。
  5. ライセンス: LoRA 自体のカードにあるライセンスを確認してください。アダプターの作者が定めるものです。

最初のリクエスト

loras の各エントリは、直接リンクと強度を受け取ります。上のプール脇の画像のリクエスト全体は次のとおりです。

json
{
  "model": "prefect/pony-xl-lora/text-to-image",
  "prompt": "vztdzsxx, vector art, flat color, vector illustration, score_9, score_8_up, score_7_up, source_anime, rating_safe, 1girl, solo, mature female, adult woman, tanned skin, long black hair, yellow one-piece swimsuit, sunglasses on her head, sitting at the edge of a swimming pool, palm tree shadows, summer afternoon",
  "aspect_ratio": "1:1",
  "seed": 33,
  "loras": [
    {
      "path": "https://huggingface.co/EarthnDusk/Loras2024/resolve/main/Flat_Vector_Art_PDXL.safetensors",
      "scale": 1
    }
  ]
}

試したどのスタイル LoRA でもうまくいったプロンプトの順序は、トリガーワード、品質タグ、ソースタグ、レーティングタグ、シーンの順です。提供元はタグ形式のプロンプトがよく効くとしていて、品質ブロックの先頭に score_9, score_8_up, score_7_up を置くことを勧めています。Pony のプロンプトでは source_anime のようなソースタグと、レーティングタグ(rating_safe、rating_questionable)も使います。当社はすべてのプロンプトに adult woman や mature male と書いています。出力形式は既定で JPEG で、PNG と WebP も選べますが、ほかには何も変わりません。パラメータと最新の料金はテキストから画像のページにあります。

トリガーワード:スタイル LoRA はどれも専用のものを求めた

Flat Vector、InkPunk、Art Deco の各アダプターは、トリガーワードをプロンプトの先頭に置いたときにそれぞれ見た目が変わりました。いちばんわかりやすいのは InkPunk で、end_inkpunk_style, inked, ink wash, ink splatter を前に付けると、革ジャケット姿でバイクに乗る女性が、強度 0.9 で濡れた絵画調の夜景になって返ってきました。

短い赤髪の女性が、赤いドレスの上に黒い革ジャケットを着て、雨のネオン街でバイクに横向きに座っている。墨絵調のスタイル

Prefect Pony XL LoRA、テキストから画像、832×1216(2:3)、seed 31、InkPunk LoRA を強度 0.9 で使用。

カードでトリガーワードを確認し、先頭に置き、残りのプロンプトはいつものタグ順に保ってください。同じ手を使えば、一連の作品をまとめて作れます。被写体の行だけを変え、LoRA、強度、品質タグはそのままにすれば、画像どうしの見た目がそろいます。次は、同じ LoRA を 0.8 で使った探偵です。

長い黒いコートとフェドーラ帽の男が、雨の降る夜の路地で街灯の下に立っている。墨絵調のスタイル

Prefect Pony XL LoRA、テキストから画像、768×1344(9:16)、seed 35、InkPunk LoRA を強度 0.8 で使用。

強度:LoRA をどこまで効かせるか

scale は 0 から 4 までです。当社のテストでは、ピクセルアート LoRA は 1 で画面全体がピクセルアートになり、0.5 では軽い効き方でした。つまり強度はオンオフのスイッチではなく、本物のダイヤルです。提供元は 0.7〜1.0 あたりから始め、アダプターを重ねるときは各強度を少しずつ下げることを勧めています。当社が掲載した例もその範囲に収まっていて、InkPunk は 0.8 と 0.9、Flat Vector と Art Deco は 1 です。

強度効果使いどころ
0フィールドが受け付ける最小値このエンドポイントでは未テスト
0.5軽い効き方(当社のテストではピクセルアート LoRA)味付け程度、または重ね掛けの2つ目のアダプター
0.7〜1.0提供元が勧める開始帯スタイル1つのときの標準
1 超4 まで受け付ける1 でもまだ弱く感じるときだけ。使う前に必ず試すこと

このエンドポイントで 1 を超える範囲を端から端まで試してはいないため、2 や 4 がどう見えるかは記述しません。試す場合は、数字を一度に一つだけ変え、seed は固定してください。

Guidance 1〜20:最適な位置はどこか

このエンドポイントには 1 から 20 の guidance_scale があり、既定値は 3.5 です。1つのプロンプトと seed でスイープして得た読み取りは次のとおりです。

Guidance見えたもの
0プロンプトが完全に無視され、関係のないスケッチが返ってきた。公開範囲が 1 から始まるのはこのため
1色が淡く、ぼんやりしていた
3.5バランスが良い。既定値
7コントラストと彩度が高くなった
12焼けたような仕上がり。きつく、彩度が過剰

LoRA の見た目にもう少し強さが欲しいときは、3.5 から少しずつ上げてください。このガイドの冒頭にあるアール・デコのタンゴは 5 を使い、金色を焼かずにくっきり保てました。12 より上に品質を求めて探す必要はありません。範囲の上限は存在しますが、当社には使い道がありません。

1920年代の舞踏室でタンゴを踊る大人のカップル。女性は金色のビーズドレス、男性は黒いタキシード。幾何学的な金色の模様のシャンデリアの下

Prefect Pony XL LoRA、テキストから画像、16:9(1344×768)、seed 34、Art Deco LoRA を強度 1、guidance 5 で使用。

3つの LoRA を重ねる

最大3つまで読み込めます。4つ目は拒否されます。当社のテストでは、0.8、0.5、0.3 の3つの LoRA が一緒に働き、主役のスタイルも読み取れる状態を保ちました。守られた原則は、重視するスタイルをいちばん高くし、ほかは低めにして加え、重ねるときは単独で使う場合より各強度を少し下げることです。画面が濁ったら、プロンプトに手を付ける前にアダプターを一つ外してください。

テストしていないことも書いておきます。当社が最も強いコンテンツのプローブで実行したのは LoRA 1つのリクエストで、複数のアダプターを重ねたものは試していないため、その組み合わせについては何も主張しません。

無音の失敗:ベースモデル違いの LoRA

別のベースモデル用に学習された LoRA は、エラーなしで読み込まれ、何も変えません。 このエンドポイントに Z-Image の LoRA を読み込んだところ、リクエストは成功し、出力はファイルなしで実行したものとピクセル単位で同一でした。同じプロンプトと seed で、アダプターの有無で見た目が変わらないなら、そのファイルは別のモデル向けに学習されたものです。

確認にかかるのは画像2枚分です。プロンプトを一度 LoRA なしで、一度 LoRA ありで、同じ seed で実行して比べます。見た目の変化が微妙なスタイルもあるので、トリガーワードのスタイルがそもそも現れているかどうかで判断してください。

リクエストが失敗した、または LoRA が効かなかった理由

症状原因対処
成功するが、画像が LoRA なしと同一別のベースモデル用に学習されたアダプター同じ seed で有無を比較し、Pony 向けのものを探す
スタイルがほとんど見えないトリガーワードがない、または強度が低すぎるトリガーワードを先頭に置き、0.8〜1 を試す
直接ダウンロードリンクを求めるエラーファイルではなくリポジトリのページを貼ったresolve/main/...safetensors のリンクを使う
Failed to load LoRA ... 401ログインが必要なゲート付きリポジトリ公開されているファイルを選ぶ
送信時に拒否されるLoRA が3つを超える、強度が 4 を超える、guidance が 20 を超える、またはプロンプトが空リクエストを直す
関係のないスケッチguidance_scale が 01 以上にする

リンクとゲート付きファイルのエラーは、無効なリクエストとして返ります。

サイズ:9つの比率から外れない

9つのアスペクト比は SDXL ネイティブのサイズに対応していて、9つすべてが要求どおりのサイズで完了しました。

比率サイズ
1:11024×1024
16:91344×768
9:16768×1344
4:31152×896
3:4896×1152
3:21216×832
2:3832×1216
21:91536×640
9:21640×1536

上流は1辺 256〜1536 を受け付けますが、ネイティブの形から外れて 1536×864 を試したところ、4回中3回で人物が重複して描かれました。公開 API がネイティブの形だけを提供しているのはそのためです。1回のリクエストで作られるのは1枚で、バッチ枚数の指定はありません。

LoRA なしでもうまくいった日常的なプロンプト

このエンドポイントは、LoRA がまったくなくても問題なく動きます。このバーテンダーは、何も読み込まずにタグ形式のプロンプトだけで生成されました。

text
score_9, score_8_up, score_7_up, source_anime, rating_safe, 1boy, solo, mature male, adult man, 30 years old, messy black hair, stubble, white shirt open at the collar, rolled sleeves, forearm tattoos, bartender pouring a cocktail behind a bar, warm amber light, bottles on shelves, smile
無精ひげの大人の男性が、襟元を開けた白いシャツの袖をまくり、温かい琥珀色の光とボトルの並ぶ棚を背にバーカウンターの向こうに立っている

Prefect Pony XL LoRA、テキストから画像、4:3(1152×896)、seed 32、LoRA なし。

同じレシピに InkPunk アダプターを 0.8 で加えると、夕暮れの砂漠のガソリンスタンドの男になります。

黒い革ジャケットのひげの男が、夕暮れの砂漠のガソリンスタンドでクラシックカーにもたれている。墨絵調のスタイル

Prefect Pony XL LoRA、テキストから画像、3:4(896×1152)、seed 62、InkPunk LoRA を強度 0.8 で使用。

どこまで対応するか

これらのエンドポイントは規制なしで、プラットフォームはコンテンツフィルターを一切かけません。すべてのプロンプトで大人であることを明記したうえで、通常のエンドポイントで7段階のコンテンツ段階を試したところ、すべての段階が書いたとおりに返ってきました:L1 ほのめかし(下着、ずり落ちる肩紐)、L2 成熟したテーマ、L3 強め、L4 高強度(成人同士の親密なシーン)、L5 極限(成人同士の同意に基づく拘束、または映画的なゴア表現)。L3 の段階の男性版も書いたとおりに返りました。ゴア表現の段階では血と傷はレンダリングされましたが、切断された四肢は描かれませんでした。これは各1回の実行からの読み取りであり、すべてのプロンプトに対する保証ではありません。最も強い段階で複数の LoRA を試してはいません。

Pony XL LoRA か、通常の Prefect Pony XL か

通常の Prefect Pony XL は、LoRA スロットのない同じチェックポイント系統です。専用のエンドポイントページには、LoRA スロット、画像入力、ネガティブプロンプト、バッチ枚数がなく、size は SDXL ネイティブの形から選び、課金は1枚単位だと書かれています。LoRA ファミリーは、そこに loras フィールドと guidance_scale のダイヤルを加えたものです。

やりたいこと選ぶもの
特定のスタイルファイルなしで、タグプロンプトからアニメを作るPrefect Pony XL
Pony LoRA による名前の付いたスタイル、キャラクター、作者の画風Prefect Pony XL LoRA、強度 0.7〜1、トリガーワードを先頭に
LoRA の見た目のコントラストと彩度を調整するPrefect Pony XL LoRA、guidance を 3.5 から 7 まで上げる
別のモデル(FLUX、Z-Image、Illustrious)向けに学習されたスタイルこのエンドポイントではなく、ファイルに合ったファミリーを使う
既存の画像を編集するこのエンドポイントではない。画像入力がない

FAQ

Hugging Face や Civitai の LoRA は何でも使えますか?

Pony 系 SDXL モデル向けに学習されたファイルだけで、しかも .safetensors ファイルへの公開された直接リンクとして渡す必要があります。当社は Hugging Face のリンクをテストしており、Civitai のリンクはテストしていません。

強度はいくつから始めればよいですか?

提供元の推奨どおり 0.8〜1 あたりから始め、少しずつ動かしてください。当社のテストでは、ピクセルアート LoRA は 1 より 0.5 のほうが軽い効き方でした。

同時にいくつの LoRA を読み込めますか?

3つまでで、4つ目は拒否されます。当社のテストでは、0.8、0.5、0.3 の3つで主役のスタイルが読み取れる状態を保ちました。

このエンドポイントで guidance は何をしますか?

プロンプトにどれだけ強く従わせるかを決めます。1つのプロンプトと seed では、1 は色が淡く、3.5 はバランスが良く、7 はコントラストと彩度が高く、12 は焼けたような仕上がりでした。guidance 0 はプロンプトを無視したため、公開範囲は 1 から始まります。

LoRA を読み込んでも何も変わらなかったのはなぜですか?

おそらく別のベースモデル用に学習されたもので、その場合は無音で失敗します。Z-Image の LoRA はここでエラーなしで読み込まれ、画像はファイルなしの実行と同一でした。ファイルの有無で1組を実行してみてください。

トリガーワードは必要ですか?

当社が使ったスタイル LoRA は、どれも専用のものを求めました。vztdzsxx、end_inkpunk_style、end_artdeco_inspo です。カードを読み、トリガーワードを先頭に置き、その後に品質タグを続けてください。

好きなサイズを選べますか?

いいえ。9つのアスペクト比を使ってください。ネイティブの形から外れると、あるテストサイズでは4回中3回で人物が重複して描かれました。

同じ seed なら同じ画像になりますか?

そうなることも多いですが、約束はしないでください。1時間空けた同一リクエストの1組はピクセル単位で同一でしたが、パイプラインでそれに頼ることはお勧めしません。

他の言語 English · 한국어 · Deutsch · Français · Español · Português (Brasil) · Русский · Italiano · Polski

実際に試してみる

支払いは実行した分だけ。プランもサブスクリプションもありません。

使用モデル:MiniMax H3 · ByteDance Seedance 2.0 Fast