はじめに
渡した画像をプロンプト内で番号指定し、差し替えや変更の内容を伝えます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| モデルの提供元 | 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 文字以内で記述し、元画像を Image 1、Image 2 などで指定します。文章の長さは画像の固定単価に影響しません。 1 文字以上 · 8000 文字以内 |
image_urls | はい | 編集に使う元画像の URL を 1〜5 件渡します。入力枚数に応じた別の料金区分はありません。 1 件以上 · 5 件以内 |
aspect_ratio | いいえ | 編集では 1:1、2:3、3:2、16:9、9:16 に対応します。既定値は 1:1 で、どの形でも料金は同じです。 |
料金
$0.028 / 枚
Grok の編集は出力画像ごとに固定料金がかかります。アスペクト比による単価の差はなく、編集が失敗した場合は無料です。
ユースケース
ブティックのファッション案
服、暖かな店舗照明、斜めの鏡で肖像を企画します。試着室の 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 の編集は 1–5 枚の元画像と文章から始めます。写真やデザインに残したい細部がある場合に使い、元画像が素材、prompt が修正と保持を伝えます。
茶筒は包装の限定的な例です。無地の筒に手描きの梅と金箔のラベルが付き、ふた、天板、光を保ちました。類似の変更を計画する参考ですが、すべての編集で他の細部が変わらない保証ではありません。
入力と出力の形
| パラメータ | 値 | 準備する指示 |
|---|---|---|
| prompt | 最大 8,000 文字 | 変更、参照の役割、保持する細部を示します。 |
image_urls | 元画像の URL を 1–5 個 | prompt の Image 1、Image 2 以降と順番をそろえます。 |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | 出力比率を選び、既定は 1:1 です。 |
実測した茶筒のラベルなら元画像 1 枚で足ります。別の参照に明確な役割がある場合に追加します。Image 1 を商品、Image 2 をラベルの図柄にするのは、検証例とは別の指示パターンの提案です。
比率も編集の条件として設定します。生成と同じ形で、既定は正方形です。場面の文章に判断を任せず、配置先に合わせて縦横を選びます。
編集の説明を組み立てる
参照ごとの役割を明確に
どの写真に筒があるか、どれが別の図柄を供給するか、必要ならどれで場所を決めるかを書きます。送信前に image_urls の順序と照合します。参照が増えても関係の説明は必要です。
置き換えを具体的に
包装例の変更は、手描きの梅の花と金箔のアクセントのラベルです。漠然と改善を求めず、対象物と新しいデザイン、素材、場所を特定します。
残す細部を列挙
変更の後に保持部分を続けます。茶筒はふた、机、光を固定目標とし、出力後に各々を元と比較します。残したいものが変わったら次の指示で明示し、次の結果も確認します。
人物の元写真を準備
人物の編集は使用権のある成人の写真に限り、なりすましをしません。このページの案は 30 代以上を指定します。服装、雰囲気、場所、光を編集条件として説明し、保持の指示は許可された入力人物に結び付けます。
編集テストが確認した範囲
茶筒の実測は花と金箔の図柄を加え、ふた、天板、元の光を保ちました。具体的な保持一覧のある個別の変更です。人物の同一性、正確な文字、繰り返す編集の保証にはしていません。
試着室の鏡は text-to-image なので、編集の一貫性の検証ではありません。提案した人物や 2 枚の商品 prompt も新しい依頼の案です。他の例をその構図の証拠とせず、実際の入力と比較します。
料金、フィルター、保存
出力画像ごとの固定単価で、aspect_ratio では変わりません。送信前に 現在のモデルページの単価 を確かめます。失敗した編集は課金されません。
公開元のコンテンツフィルターで検出すると拒否され、無料です。入力数と文章の制限を守ります。公開設定は prompt、image_urls、aspect_ratio で、ほかで紹介される mask や quality はこの表のパラメータではありません。
結果は 14 日間の保存期間内に取得し、その後は削除されます。次の変更の基準として、元画像、順序、採用指示、保存結果をまとめます。
別の処理が向く場合
元写真の保持が不要な新しい場面なら同じファミリーの text-to-image を使います。5 枚を超える参照が必要なら最大 10 枚の Nano Banana 2 Lite、指定文字とマスクによる変更なら 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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 リファレンスを参照してください。











