リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 · 2:3 · 9:16 · デフォルト: 1:1 |
prompt | はい | Describe the image to generate: subject, composition, style, and lighting. |
reference_image_urls | いいえ | 結果に残したい人物・衣装・場所の参照画像。 |
reference_strength | いいえ | How strongly the reference images shape the result, from 0 to 1. At 1 the composition can carry over too; lower values mostly keep the palette and texture. ≥ 0 · ≤ 1 · デフォルト: 1 |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| 標準 | 2.25 | $0.023 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 3クレジット/枚($0.03)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Krea 2 Medium Turbo API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を krea/2-medium-turbo/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-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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 Turbo API についての質問
Krea 2 Medium Turbo API の料金はいくらですか?
Krea 2 Medium Turboは3クレジット($0.03)/枚です。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのKrea 2 Medium Turboのモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は krea/2-medium-turbo/text-to-image を指定します。
Medium Turbo は Krea 2 Large と何が違いますか?
Large はディテールと素材感の上限が高く、そのぶん遅いティアです。Medium Turbo は量のために作られています。prompt は同じ 5,000 文字、アスペクト比も同じ 8 種、参照画像も最大 10 枚まで同じなので、リクエストはそのまま持ち回せます。
参照画像を渡したり creativity を調整したりできますか?
参照画像は渡せますが、creativity の調整はありません。`reference_image_urls` は最大 10 枚を受け取ります。既定の `reference_strength` 1 では色調、粒子、素材、光に加えて構図まで持ち込み、値を下げると主に色と質感が残ります。
Krea 2 Medium Turbo API の制限は?
アスペクト比:1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 +2;参照画像:10;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにKrea 2 Medium Turboを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでKrea 2 Medium Turboを実行でき、実行ごとに対応するコードが表示されます。

