はじめに
シーンの説明を送り、正方形、縦長、横長の構図を選びます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| モデルの提供元 | xAI |
| 識別用の名前 | grok/imagine-image-2.0 |
| 画像の処理 | text-to-image の生成と image-to-image の編集です。 |
| 文章の制限 | 両方で最大 8,000 文字です。 |
| 編集の元画像 |
|
| 元画像の呼称 | 入力順に Image 1、Image 2 以降です。 |
| 使える比率 | 1:1、2:3、3:2、16:9、9:16 |
| 既定のキャンバス | 生成・編集とも 1:1 です。 |
| 料金の基準 | 画像ごとの固定単価で、比率では変わりません。失敗したタスクは課金しません。 |
| 取得できる期間 | 生成画像は 14 日後に削除します。 |
主な機能とハイライト
1 つの試着室に繰り返す鏡像
2:3 の試着室は、暖かなブティックの光と斜めの鏡の中で男性がシルクのシャツを持ちます。この結果では鏡像が一貫して繰り返されました。人物、衣服の小道具、部屋、光をまとめて指示する参考にし、別の配置でも同じと考えず各反射を確認してください。
盆栽サイズの苔の庭師
ロボットの庭師のテストは、苔をまとった人物が盆栽に水をやり、説得力のあるマクロの質感になりました。小さい被写体、明確な動作、近い写真の視点で大きさが伝わります。求める表面と光を書き、出力で評価します。この例の根拠であり、一般的な画質評価ではありません。
ラベルを変えて場所を保つ
茶筒では、無地の図柄が手描きの梅と金箔のラベルに変わり、ふた、机、光は残りました。保持の目標を示した限定的な編集の結果です。筒を Image 1 と呼び、新しいラベルと残す周囲を列挙し、元写真と照合します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | シーンを 8,000 文字以内で説明します。このテキスト欄によって画像の料金が変わることはありません。 1 文字以上 · 8000 文字以内 |
aspect_ratio | いいえ | 1:1、2:3、3:2、16:9、9:16 を選べます。既定は 1:1 です。 |
料金
$0.028 / 枚
Grok で生成する画像は、形にかかわらず 1 枚あたり固定料金です。生成に失敗した場合は請求されません。
ユースケース
ブティックのファッション案
服、暖かな店舗照明、斜めの鏡で肖像を企画します。試着室の 2:3 サンプルは同じ男性の鏡像が一貫しており、この構図の具体的な参照です。
素材の細部を持つ小さな世界
関係のない物を並べるより、小さなキャラクターに分かりやすい仕事を与えます。苔のロボットは盆栽に水をやり、マクロ場面の表面の質感を示しました。
既存の茶筒に包装の図柄を
採用した商品写真から新しいラベルを依頼します。茶筒の実測編集は手描きの梅と金箔を加え、ふた、天板、光を保ちました。
参照の役割を決めた編集
複数の元が必要なら最大 5 枚を使い、各番号が供給する要素と保持部分を説明します。枚数は操作上の機能で、すべての構図が参照に合う根拠ではありません。
縦と横のコンセプト配置
配置先に合う縦、正方形、横の画面を生成前に選びます。生成と編集に共通の 5 比率があり、形を変えても画像単価は一定です。
プロンプトガイドと実践のヒント
文章か写真かを決めます
新しい絵は文章から、修正は 1–5 枚の元画像から始めます。写真の使用権を確認し、編集入力の人物は成人とし、なりすましを避けます。
場面や変更を具体化
新規場面には被写体、動作、場所、光を与えます。編集では Image 1、Image 2 以降の役割と残す細部を指定します。
配置先に合う比率を選択
1:1、2:3、3:2、16:9、9:16 から構図に合わせます。既定は正方形で、比率によって画像単価は変わりません。
細部を確認し保存
結果を説明と比べ、必要なら反射や保持した物を確認します。取得可能な 14 日間にダウンロードし、prompt も残します。
文章の説明から場面を作る
Grok Imagine Image 2.0 text-to-image は説明から画像を生成します。既存写真の細部を使う必要がなく、場面のアイデアがある場合に使います。作業する小さなロボットと写真風の試着室の肖像は、被写体と周囲を中心に説明を組む 2 つの例です。
この生成には prompt と比率設定があります。配置先の形を選んだうえで、画面内に何を描くかを文章にします。採用した商品写真のラベルなどを修正するなら、同ファミリーの image-to-image を使います。
パラメータと構図
| パラメータ | 対応値 | 用途 |
|---|---|---|
| prompt | 最大 8,000 文字の場面説明 | 被写体、動作、素材、場所、光を書きます。 |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | 画面比率を選び、既定は 1:1 です。 |
縦なら 2:3 や 9:16、横なら 3:2 や 16:9 を選べます。試着室は男性と鏡の部屋を縦に捉える 2:3 です。aspect_ratio を変えなければ正方形になります。prompt に縦と書いても、この設定は意図して選んでください。
画像に伝わる説明を書く
被写体と動作を結びます
中心の対象に分かりやすい行動を与えます。ロボットなら盆栽への水やりで人物、水、植物がつながり、試着室ならシャツを持たせることで衣服の小道具が場面に属します。人物は 30 代以上にします。
表面と光に目的を与えます
苔と金属、シルクと仕立てたズボン、暖かな店の磨かれた鏡など、素材の言葉で見たいものを説明します。マクロの縮尺や柔らかな店舗照明と組み合わせ、無関係なスタイル名より被写体に合う具体的な選択を使います。
確認する配置を説明します
鏡があれば人物との関係を説明して反射を確認し、小さな物の縮尺なら近くの植物や視距離を指定します。これらは説明の方法で、物理的な正確さの保証ではありません。重要な細部を記録して同じ要件で評価します。
当社の例が示すこと
- 庭師のテストは苔のロボットが盆栽に水をやり、良好なマクロの質感がありました。掲載した素材研究の根拠で、すべての小物シーンではありません。
- 試着室の 2:3 の肖像は、上半身に服のない男性がシルクのシャツを持ち、斜めの鏡に一貫して映りました。
- 茶筒は編集例で、ふた、机、光を残してラベルを変えました。既存の細部を基準にするなら編集を選びます。
ギャラリーは観察可能な結果の集まりです。小さな質感と反射は別々の例で、他の prompt の同一品質は測定していません。追加の prompt 案は提案で、追加のテスト結果ではありません。
料金と制限
生成画像は固定単価で、対応比率を変えても同じです。実行前に Grok Imagine Image 2.0 のモデルページ で現在の額を確認してください。失敗した生成には課金しません。
公開元のコンテンツフィルターで検出された依頼は拒否され、無料です。文章の上限と比率一覧に従います。ここでの設定には解像度や品質の選択はなく、一般レビューの設定を持ち込まないでください。
完成画像は 14 日間取得でき、その後削除します。採用画像と文章、比率を保存します。再試行では必要な細部を明確に直し、同じ説明を基準に比較してください。
次の作業の選び方
残したい細部のある写真の限定的な修正は image-to-image に渡します。別の形が必要なら Nano Banana 2 Lite は生成で 14 比率に対応します。指定文字のポスターには Ideogram 4.5 も候補で、テストで題名と補助行が明瞭でした。モデルを一律に順位付けせず、設定要件と実際の結果で選びます。
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": "xai/grok-imagine-image-2.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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 リファレンスを参照してください。










