はじめに
Krea 3 テキストから画像は、Krea が指示に従う編集を最初の目的として作った自社開発の画像モデル Krea 3 で、平易な文章のプロンプトから 1 枚の画像を描きます。約 1 MP の 10 種類のアスペクト比から選び、高品質版か高速版を選択できます。どちらも料金は同じです。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章での説明 | Krea 3 テキストから画像 |
| 変更または組み合わせたい写真 1 〜 8 枚 | Krea 3 画像編集 |
主な機能とハイライト
フィルム写真のリアリズム
当社のテストでは、Krea 3 は肌、布、夕方の光を、スキャンしたフィルムのネガのように描きました。プロンプト末尾の短いスタイル指定から、粒子、ハレーション、自然な色かぶりが現れました。
10 種類の形状、一律の料金
21:9 から 9:16 まで。どれも約 1 MP で、その大きさのまま生成されます。提供するすべての大きさは実際のリクエストで確認済みで、形状によって料金は変わりません。
追加料金なしの思考の切り替え
enable_thinking をオンにすると、モデルは描画の前にプロンプトをより長く計画します。当社のテストでは待ち時間がおよそ 2 倍になり(約 30 秒)、料金は変わりませんでした。
ファッション程度のコンテンツのみ
描画の前にリクエストが審査されます。軽めのファッションは描画され、中程度以上のプロンプトは約 2 秒以内に拒否されて、課金されませんでした。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 文で描写してください。誰か、何を着ているか、どこか、光、最後にフィルムか色調の指定。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 出力の形状:1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9、21:9 のいずれか。既定は 1:1。 |
quality | いいえ | high(既定)は細部を重視し、fast は早く返ります。料金は同じです。 |
enable_thinking | いいえ | 描画の前にプロンプトをより長く計画します。当社のテストでは約 2 倍の時間がかかりました。 デフォルト値: |
negative_prompt | いいえ | 除外したいものを最大 1,024 文字まで。高品質版でのみ使われます。 1024 文字以内 |
output_format | いいえ | PNG(既定)か JPEG。料金への影響はありません。 |
seed | いいえ | 任意で、0 〜 2147483647。seed を再利用すると以前の画像に近づきますが、一致する保証はありません。 |
料金
$0.036 / 枚
1 枚ごとの一律料金です。アスペクト比、品質版、思考では料金は変わりません。拒否されたリクエストには課金されません。
ユースケース
エディトリアルとルックブックの静止画
写真調の仕上がりのファッション、インテリア、ポートレートを、ムードボードやキャンペーンの下書きにそのまま使えます。
ワイドなバナーと縦長のストーリー
同じプロンプト、同じ料金で、21:9 のヘッダーと 9:16 の縦長フレームを作れます。
プロンプトガイドと実践のヒント
撮影指示書のように書く
誰が、何を着ていて、どこにいて、どんな光で、最後に 1 行のフィルムと色調の指定。Krea 3 は完全な文をよく読み取ります。
下書きは速く、仕上げは高品質で
高速版で構図を決め、残したい 1 枚は高品質版に切り替えてください。seed を再利用すると近い画像になりますが、完全に一致するとは保証されません。
ネガティブプロンプトは短く
negative_prompt は高品質版にのみ適用されます。「text, watermark」のような数語で十分です。
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": "krea/3/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high",
"aspect_ratio": "1:1",
"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 リファレンスを参照してください。










