はじめに
Prefect Pony XL は、Pony XL 系のコミュニティ製チェックポイントマージです。SDXL をベースに、アニメとイラスト向けに調整されています。このカタログのフォトリアルな画像モデルに対するアニメ版で、規制はありません。どんなプロンプトも、フラグも別の呼び出しもなく、このエンドポイントで動きます。
エンドポイントが受け付けるのは、5,000 文字までのプロンプト、7 種類ある SDXL ネイティブサイズのいずれか、任意の seed、JPEG・PNG・WebP の出力形式で、1 回の呼び出しにつき 1 枚を返します。
主な機能とハイライト
使い慣れたタグの書き方をそのまま生かす
Pony XL は、意図して並べた説明的なタグで書くことに慣れた作り手のための、テキストから画像の選択肢です。被写体、画風、構図、光を決まった順に並べておけば、プロンプトのライブラリを管理する人にとっても読みやすいままです。
創作上の判断は 1 回に 1 つだけ変える
うまくいく構図を決めたら、試行ごとに変える大きなアイデアは 1 つだけにします。しぐさ、衣装、背景、光のいずれかです。結果を並べて比べ、毎回を無関係なコンセプトとして扱うのではなく、意図を保っているプロンプトの版を残してください。
公開する前に適切かどうかを確かめる
解剖学的な正しさ、構図、文字の描写、見た目の一貫性を、納品予定の解像度で判断します。外部で使う前に、プロンプトと結果のそれぞれが自社の公開方針と、参照したキャラクター、人物、ブランドの権利に沿っているかを確かめてください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 説明文よりカンマ区切りのタグが強く効きます。品質タグを先頭に、次に被写体と衣装、最後に光とレンズ。 1 文字以上 · 5000 文字以内 |
size | いいえ | SDXL ネイティブな 7 種。任意の幅・高さは受け付けません——学習外の比率は人体破綻の主因なので、学習済みのピクセル数だけを公開しています。 |
output_format | いいえ | PNG は可逆でレタッチ向き、WebP はそのまま掲載向き、JPEG は転送量重視。生成内容にも料金にも影響しません。 |
seed | いいえ | 同じプロンプト・サイズと合わせて渡すと同じ絵が再現されます。省略すると毎回変化します。 |
料金
$0.015 / 枚
ユースケース
文章のブリーフから始める
タグを並べて書くアニメやイラストの画像に使います。先にサイズを選んでください。1024*1024 から 1344*768 まで、SDXL ネイティブの 7 種類です。そのうえで品質タグ、被写体、衣装の順にプロンプトを組み、ポーズが決まったら seed を固定します。
規制なしのイラストを大量に
ホスティングされたモデルが断るような大胆なアニメ作品も、通常のエンドポイントで、フラグもレビューキューもなしに動きます。ポーズが決まったら seed を固定し、その周りで衣装と照明を繰り返し調整してください。料金は 1 フレームごとなので、試行の実行と最終レンダーは同じ価格です。
ファンアートや SNS 投稿
プロンプト 1 つで 1 枚、数セントです。WebP を選べば、途中で再エンコードせずにそのままページやフィードに載せられます。
キャラクターシートと資料
同じキャラクターを 7 つの形で生成します。アバターには正方形、全身のシートには 2:3、バナーには 16:9 です。seed を使い回し、構図のタグだけを差し替えます。学習を回さなくても、十分にまとまった資料一式ができます。
プロンプトガイドと実践のヒント
残したい 1 枚が出たら seed を固定する
seed はプロンプトと一緒に保存してください。seed がないと同じ 1 枚は作り直せません。ほぼ同じプロンプトでも新しい seed では別のキャラクターになり、同じキャラクターのバリエーションにはなりません。
品質タグを先に、被写体はその後に
この系統は、説明的な文章よりも Pony 系で使われるスコアや品質のタグの慣習にずっとよく反応します。そうしたタグを先頭に置き、次に被写体と衣装、その後に光、レンズ、背景を書きます。文章でも動きますが、効き目は弱くなります。
付属の例を作り替える
公開している例から始め、output_format は png、size は 1216*832 にします。被写体と演出を入れ替えつつ、このモードの入力の決まりはそのまま保ちます。
score_9, score_8_up, 1girl, solo, silver twin tails, oversized varsity jacket, denim shorts, standing on a neon-lit city street at night, rain reflections, looking at viewer, cinematic lighting, detailed background
横長の形もネオンも、どちらもプロンプトに書いてあります。この系統は、衣装のタグと同じくらい素直に光のタグを読み取ります。
反復する前に結果を確かめる
項目は prompt、size、seed、output_format の 4 つだけです。画像の入力、ネガティブプロンプトの欄、ステップ数やガイダンスの調整、LoRA の枠、生成枚数の指定はありません。チェックポイントのサンプラー設定は基になるモデル側で固定されています。サイズは SDXL ネイティブの 7 種類に限られ、任意の幅と高さは受け付けません。1 回の呼び出しで返るのは 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/text-to-image",
"input": {
"size": "1024*1024",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"output_format": "png"
}
}'
# 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 リファレンスを参照してください。
