SpicyAPI の Krea 2 にはサイズ設定がありません。比率を選ぶと、Krea が公開している唯一のスケール 1K(約 1 メガピクセル)が、以下のサイズで返ってきます。 選ぶモデルで変わるのはコスト、速度、見た目であり、ピクセル数ではありません。Medium Turbo ($0.015) で探索し、完成させる一枚は Large ($0.06) で効く表現を使い、Medium ($0.03) は 3:4 や JPEG/PNG の選択が要るときだけ選びます。
比率ごとのピクセル数
これは Krea がスケール 1K について公開しているサイズです。受け取ったファイルを開くと、実際の幅と高さが分かります。3 つのタスクのいずれも width、height、resolution、seed を受け取らず(すべて 400 を返します)、つまり 1K が上限でもあります。
| 比率 | ピクセル | モデル | 用途 |
|---|---|---|---|
1:1 | 1024 × 1024 | 3 つすべて | アバター、グリッドカード |
4:5 | 928 × 1152 | Large、Turbo | フィードの縦ポートレート |
3:4 | 非公開 | Medium のみ | 縦長カード |
2:3 | 832 × 1248 | Large、Turbo | ポスター、縦長カード |
9:16 | 768 × 1376 | 3 つすべて | ストーリー、モバイル全画面 |
4:3 | 1184 × 896 | 3 つすべて | スライド、商品写真 |
3:2 | 1248 × 832 | Large、Turbo | 横長の写真 |
16:9 | 1376 × 768 | 3 つすべて | バナー、動画のサムネイル |
2.35:1 | 1568 × 672 | Large、Turbo | シネマティックな帯 |
公開する形と同じ比率で生成してください。切り抜きは支払った構図を捨てることになりますし、また同じ幅のまま 3:4 を 4:5 に変えると高さが 6.25% 減ります(1200 × 1600 は 1200 × 1500 になります)。余裕を持たせてください。サイズは掲載位置に合わせて確認します。1080 × 1350 のフィードカードは 4:5 のファイルを約 1.17 倍に拡大し、1920 × 1080 のヒーロー画像は 16:9 のファイルを 1.4 倍に拡大します。それより大きな用途や印刷に使う場合は、完成画像をアップスケールしてください。画像高解像度化ガイドが段階と価格を掲載しています。
どのモデルを選ぶか
| タスク | 画像あたりの米ドル | レファレンスあり | 比率 | その他の調整 |
|---|---|---|---|---|
krea/2-medium-turbo/text-to-image | $0.015 | $0.0175 | 8、2.35:1 を含む | スタイルレファレンス最大 10 枚 |
krea/2-medium/text-to-image | $0.03 | 受け付けない | 5: 1:1、4:3、3:4、16:9、9:16 | output_format: png(デフォルト)または jpeg |
krea/2-large/text-to-image | $0.06 | $0.065 | 8、2.35:1 を含む | スタイルレファレンス最大 10 枚 |
レファレンスは画像ごとではなくリクエストごとに一律で加算され、3 枚でも 1 枚でも同じ金額になります。3 モデルとも最大 5000 文字のプロンプトを受け取り、既定値は 1:1 です。
- Medium Turbo は最速のティアです。光源、構図、パレットの探索に、また仕上げの細部より速度とコストが重要なフィード用素材に使ってください。
- Large は最も遅く、写真的な質感のためのティアです。肌、粒子、素材、エッジの細部。納品する一枚に使ってください。
- Medium は量産向けのティアです(Krea はイラスト、アニメ、描いたような画風を想定しています)。
3:4、編集用の可逆な PNG、Large の仕上げが不要な大量生成に選んでください。ここではレファレンスを受け付けません。
Turbo と Large は同じ比率と同じ項目を受け付けるため、変わるのは model の文字列だけです。同じ絵が返るのではなく、別の描画結果になると思ってください。シードを制御する項目がないため、気に入った結果を正確に再現することはできません。採用したファイルはプロンプトと一緒に保存してください。Turbo の下書き 10 枚と Large の最終 1 枚で $0.21、Large を 11 回実行すると $0.66 です。
レファレンスが導くのはパレット、粒子、素材、光で、レイアウト、ポーズ、人物の同一性ではありません。構図はプロンプトに書いてください。
2026 年 9 月のテストでは、Large と Medium Turbo は成人向けのリクエストを拒否しました。Medium はより強い一部のリクエストを弱め、完成した出力に対して課金しました。そのような用途については Krea 2 は無検閲ですかを参照してください。衣服を着たポートレート、環境、カバーにはここで Krea を使ってください。
まずは Playground で試す
例:Turbo のネイティブ 4:5 を使った、架空の成人クリエイターによるポートレート。
- Medium Turbo のページを開き、Playground タブの Form ビューに留まったまま、サインインして実行します。
- 次のプロンプトを使います: このプロンプトを Krea 2 Medium Turbo で実行 →.
- Aspect ratio を
4:5に設定します。Reference images は任意です(使用権限のあるスタイル画像が最大 10 枚)。 - 実行して構図を確認したら、ピクセルではなく表現のほうを修正してください。外れた生成をシードで誘導し直す手段はありません。
- Large で仕上げるには Large のページを開き、同じプロンプトを貼り付けます。
3:4を使う場合は Medium のページを開き、Aspect ratio を3:4、Output format を PNG に設定します。Medium には Reference images 項目がありません。
次はコードから実行する
Python SDK (pip install spicyapi) をインストールし、サーバー環境で SPICY_API_KEY を設定してから実行します:
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="krea/2-medium-turbo/text-to-image",
input_data={
"prompt": "Editorial portrait of a fictional 35-year-old ceramic artist in an indigo work shirt "
"and cream apron. Waist-up view in a quiet warm-grey gallery. The artist holds one "
"small cobalt-blue ceramic bird at waist height. Soft side light, visible hands, "
"complete head inside the frame, restrained background, no lettering.",
"aspect_ratio": "4:5",
},
idempotency_key=str(uuid.uuid4()), # new key per new request; reuse only to retry the same one
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
print(output_assets(final)[0]["url"]) # copy the image to your own storage nowLarge で仕上げる場合は、モデルだけを krea/2-large/text-to-image に変更します。Medium の場合は krea/2-medium/text-to-image を使い、aspect_ratio を 3:4 に、"output_format": "png" を追加します。Turbo か Large にスタイルレファレンスを追加する場合は、"reference_image_urls": ["<使用権限のある画像の HTTPS URL>"] を追加します。保存したファイルを開くと、実際の幅と高さを確認できます。待機、エラー、再試行についてはタスクガイドと Python SDK リファレンス を参照してください。
Agent に実行させる
アシスタントに生成を担当させる場合、CLI、MCP サーバー、Agent Skill はいずれも最新のスキーマを読み込み、CLI と MCP は価格を表示して有料の呼び出し前に確認を求めます。同じ input オブジェクトを input.json に入れて:
spicyapi tasks create --model krea/2-medium-turbo/text-to-image --input-file input.json --waitMCP 経由では「Run Krea 2 Medium Turbo at 4:5 with this prompt.」と依頼します。npx skills add spicyapi-ai/spicy-skill で Skill を導入できます。
よくあるエラーの対処
| 問題 | 対処 |
|---|---|
Medium が 4:5 で 400 を返す | 3:4 を使って余裕を取って切り抜くか、ネイティブの 4:5 が必要なら Large か Turbo に切り替える |
Turbo か Large が 3:4 で 400 を返す | 3:4 は Medium 専用です。4:5 か 2:3 を使ってください |
reference_image_urls で 400 | Medium はレファレンスを受け付けません。Turbo か Large を使ってください |
width、height、resolution、seed で 400 | その項目を外してください。比率を選んでください |
| カードサイズで顔が小さすぎる | 半身の構図に切り替え、部屋の説明を短くし、単純な背景を依頼してください |








