Prefect Pony XL API：料金・パラメーター・コード

Name: Prefect Pony XL API
SKU: prefect/pony-xl/text-to-image
Price: 0.03 USD
Availability: InStock

リクエストパラメーター

パラメーター	必須	説明
`seed`	いいえ	同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647
`size`	いいえ	Output image size in pixels, written as widthheight. All values are native SDXL shapes. 10241024 · 8961152 · 1152896 · 8321216 · 1216832 · 7681344 · 1344768 · デフォルト: 1024*1024
`prompt`	はい	Describe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens.
`output_format`	いいえ	結果のファイル形式。 png · jpeg · webp · デフォルト: png

料金

料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。

オプション	クレジット /枚	≈ USD
標準	2.25	$0.023

タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 3クレジット/枚（$0.03）です。

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

Prefect Pony XL API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
リクエストを送る. POST /jobs/createTask に、model を prefect/pony-xl/text-to-image、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "prefect/pony-xl/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "size": "1024*1024",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Prefect Pony XL API についての質問

Prefect Pony XL API の料金はいくらですか？

Prefect Pony XLは3クレジット（$0.03）/枚です。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのPrefect Pony XLのモデル名は？

POST /jobs/createTask の model フィールドに画像を作成は prefect/pony-xl/text-to-image を指定します。

プロンプトの書き方は

カンマ区切りのタグ、品質タグを先頭に。ローカルの SDXL チェックポイントと同じ書き方がそのまま通ります。長い説明文でも動きますが、タグほど強くは効きません。

同じ絵をもう一度出せますか

出せます。同じシード・同じプロンプト・同じサイズを渡してください。シードを省くと毎回別の絵になります。残したい絵はシードごと保存してください。

参照画像は送れますか

送れません。このエンドポイントは text-to-image 専用で、画像入力もインペイントも ControlNet 系の条件付けもありません。画像を起点にしたい場合はカタログ内の image-to-image をご利用ください。

サイズが 7 種類なのはなぜですか

いずれも SDXL のネイティブ解像度だからです。SDXL 系で学習外の比率を指定すると人体が破綻しやすく、それを避けるために任意の幅・高さは受け付けていません。

Prefect Pony XL API の制限は？

プロンプトの長さ（文字）：5,000。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにPrefect Pony XLを試せますか？

はい。Playground なら API キーなしで、PopNow のクレジットでPrefect Pony XLを実行でき、実行ごとに対応するコードが表示されます。

すべての Prefect Pony XL モデル

ほかの画像 API

Prefect Pony XL についてさらに

試す: Prefect Pony XL のAI画像生成をオンラインで PopNow で Prefect Pony XL を使って画像を作る
ドキュメント: API ドキュメントの Prefect Pony XL モデル ID と入力スキーマ PopNow API クイックスタート：5 分で最初のリクエスト PopNow API 画像生成ガイド Webhook：ポーリングせずに Prefect Pony XL の結果を受け取る