Grok API:Imagine Image 2.0

grok-imagine-image-2.0 を使用して、テキストから画像への生成と画像編集のワークフローを構築できます。xAI API は、OpenAI 互換の画像エンドポイントを通じて、アスペクト比、解像度、出力枚数、レスポンス形式を設定可能にします。
xAI API キーの作成
発光するガラス彫刻と自然なスタジオ照明を使った、映画的な抽象画像生成シーン

最適な Grok 画像ワークフローの選択

プロンプト駆動の画像生成を示す、詳細で整合性のあるファンタジー風景
参照画像による画像編集ワークフロー
生成画像アセットの本番統合
本番リクエストを送信する前に、メディア入力と出力設定を検証してください。

Grok Imagine Image 2.0 API の機能

専用画像モデル

現在の Imagine Image 2.0 の生成と編集には、<code>model</code> に <code>grok-imagine-image-2.0</code> を設定します。

テキストから画像への生成

プロンプトを <code>/v1/images/generations</code> に送信し、1 回の呼び出しで最大 10 枚の画像をリクエストできます。

設定可能な出力

アスペクト比、1K または 2K 解像度、出力枚数、サポートされるレスポンス形式を選択します。

画像編集

編集指示とともに、公開画像 URL または base64 エンコードされたデータ URI を <code>/v1/images/edits</code> に送信します。

編集参照は最大 3 つ

マルチイメージ編集では、構図、被写体の組み合わせ、スタイルガイド用に最大 3 枚のソース画像を受け付けます。

Bearer 認証

xAI API キーを <code>Authorization</code> ヘッダーで送信し、認証情報をブラウザコード、ログ、リポジトリに置かないでください。
xAI は画像1枚あたりの定額料金を採用しており、解像度と品質が出力料金に影響します。

Grok API の Imagine Image 2.0 料金

生成出力の料金

xAI は現在、Imagine Image 2.0 の出力を 1K Low で 1 枚あたり $0.04、2K Low で $0.06、1K Medium で $0.06、2K Medium で $0.08 としています。

メディア入力の料金

Imagine Image 2.0 ルートの画像入力は、入力画像 1 枚あたり $0.01 とされています。したがって、編集には入力画像と生成出力の両方の費用が含まれます。

プロンプトの長さは画像料金を決定しません

画像生成では、トークン単位のプロンプト課金ではなく、画像 1 枚あたりの固定料金を採用しています。リクエストした画像枚数に選択した出力ティアを掛け、さらに編集の画像入力費用を加えてください。

最新料金の再確認

本番デプロイ前に、xAI の最新料金ページを確認してください。モデル階層と請求条件は変更される可能性があります。

Grok Image API の統合

1. API キーを作成して安全に保管する
1

1. API キーを作成して安全に保管する

xAI コンソールでキーを作成し、Authorization: Bearer $XAI_API_KEY として送信してください。キーはサーバー側で保管してください。
2. 生成または編集の選択
2

2. 生成または編集の選択

プロンプトのみで生成する場合は /v1/images/generations を使用します。ソース画像を参照させる、または変換する場合は /v1/images/edits を使用します。
3. 検証済みリクエストの構築
3

3. 検証済みリクエストの構築

modelgrok-imagine-image-2.0 を設定し、プロンプトを追加して、自社プロダクトがサポートする出力オプションだけを明示的に選択してください。
4. 送信とレスポンスの確認
4

4. 送信とレスポンスの確認

返された URL や base64 データを保存する前に、HTTP ステータスとレスポンス本文を確認してください。すべてのレスポンスに利用可能な画像が含まれるとは想定しないでください。
5. アセットの意図的なダウンロードと保持
5

5. アセットの意図的なダウンロードと保持

長期的な利用が必要な場合は、完了したアセットを自社の承認済みストレージにコピーしてください。また、重複請求を防ぐため、リトライは冪等に処理してください。
手動の画像エディタよりも、反復可能なプロンプト・編集ワークフローが重要な場所で API を使用します。

Grok Imagine Image 2.0 で開発者が構築するもの

キャンペーン用クリエイティブのバリエーション

構造化されたプロンプトテンプレートから、広告、ランディングページ、ソーシャルキャンペーン向けの複数のビジュアル方向性を生成します。

プロダクトおよびコンセプトの可視化

プロダクト概要、環境の説明、アートディレクションを、レビュー可能な画像コンセプトに変換します。

参照画像による編集

承認済みソース画像を自然言語の指示で変換します。元のアセットはワークフロー内に保持したままにします。

ローカライズ対応のビジュアル制作

リクエスト検証とアセット追跡の一貫性を保ちながら、地域、フォーマット、チャネルに応じてプロンプトの詳細を調整します。
エンドポイント、料金、モデル識別情報、画像入力、プラットフォームとの関係。

Grok API FAQ

Grok Image API の統合を開始