リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | Describe the image to generate: subject, composition, style, and lighting. |
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · デフォルト: 1:1 |
output_format | いいえ | 結果のファイル形式。 jpeg · png · デフォルト: png |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| 標準 | 4.5 | $0.045 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 5クレジット/枚($0.05)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Krea 2 Medium API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を krea/2-medium/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": "krea/2-medium/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"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 タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Krea 2 Medium API についての質問
Krea 2 Medium API の料金はいくらですか?
Krea 2 Mediumは5クレジット($0.05)/枚です。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのKrea 2 Mediumのモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は krea/2-medium/text-to-image を指定します。
Medium は Krea 2 Large と何が違いますか?
Large はディテールと素材感の上限が高く、2.35:1 のアナモルフィック比率が加わります。Medium はより速く、量のために作られています。プロンプトの語彙は同じなので、文言はそのまま持ち回せます。
Medium は Krea 2 Medium Turbo とどう違いますか?
Medium Turbo はより速いティアで、2.35:1 を含む 8 種の比率があり、スタイル参照画像を最大 10 枚受け取ります。Medium は比率が 5 種で参照入力はありませんが、png か jpeg を選べ、既定はロスレスの png です。どちらにも seed はありません。
PNG と JPEG のどちらを選ぶべきですか?
合成やレタッチへ進み、可逆なエッジが効くなら png。レビューや直接表示のためにファイルを小さくしたいなら jpeg です。変わるのは配信されるファイルであって、生成された画像そのものではありません。
参照画像を渡したり creativity を調整したりできますか?
いいえ。このエンドポイントはどんな画像入力も受け取らず、creativity の調整もありません。スタイル参照が必要なら Krea 2 Medium Turbo か Krea 2 Large を、既存の画像から始めたいなら編集モデルを使ってください。
使えるアスペクト比はどれですか?
1:1、4:3、3:4、16:9、9:16 です。このティアにワイドやアナモルフィックの選択肢はありません。2.35:1 は Krea 2 Large と Krea 2 Medium Turbo にあります。
Krea 2 Medium API の制限は?
アスペクト比:1:1 · 4:3 · 3:4 · 16:9 · 9:16;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにKrea 2 Mediumを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでKrea 2 Mediumを実行でき、実行ごとに対応するコードが表示されます。

