概要
Grok Imagine Officialは、xAIの画像モデル向けの公式チャンネルです。リクエストはAPIYIによって公式xAI APIへリレーされ、価格はxAIの定価と一致し、課金は解像度と品質ティアに従い、パラメータ検証はアップストリームと同一です。 利用可能なモデルは、標準のgrok-imagine-image、高品質なgrok-imagine-image-quality、そして最新の**grok-imagine-image-2.0**（low / medium品質ティアあり）の3つです。
すべての画像APIは同期式です。非同期タスクIDは存在しないため、クライアントが切断された場合、結果は失われますがリクエストの課金は発生します。当社のテストでは、
grok-imagine-image-2.0のmedium品質および2Kでの生成には約60〜80秒かかりますので、このモデルには長めのタイムアウト時間を設定してください。詳細は画像APIの注意事項とベストプラクティスをご覧ください。テキスト画像生成 API
テキストpromptから画像を生成します。対話型のPlaygroundも用意されています。
Grok Imagine Video
同じ
GrokOfficialグループ — テキストからの動画生成および画像からの動画生成に対応し、秒単位で課金されます。AIエージェントに統合を任せる
このpromptをコピーして Codex / Claude Code / Cursor に貼り付けてください
まずこのページのプレーンテキスト版を取得し（任意のドキュメントURLに.mdを追加）、お使いのスタックに合わせたコードを作成します。タイムアウト、URL結果の即時保存、resolutionを使用してsizeを使用しないこと、1回の呼び出しにつき1枚の画像といった処理はあらかじめ要件に組み込まれています。
このプロジェクトにGrok Imagine Officialのtext-to-imageを統合／トラブルシューティングしてください。
コードを書く前にドキュメントを読んでください：このページのプレーンテキスト版を取得するには https://docs.apiyi.com/en/api-capabilities/grok-imagine-image-official/overview.md を取得してください。…
- モデルを1つ選択してください：
grok-imagine-image、grok-imagine-image-quality、またはgrok-imagine-image-2.0…
合計8つの要件があります — 以下のボタンを使用して完全版をコピーしてください
モデルと料金
料金はxAIの定価に準拠しており、画像ごとに課金されます。階層はresolution（2.0の場合はさらにquality）によって設定されます：
モデルの料金は公式サイトに準拠しており、公式サイトの変更に伴って改定される場合があります。上記の表は参考用であり、トップナビゲーションのモデル料金タブの情報が正式なものとなります：モデル料金。
課金に関する注記
- デフォルト値：
resolutionのデフォルトは1kです。grok-imagine-image-2.0のデフォルトはquality: lowであり、画像1枚あたり$0.04となります。 - 画像ごと、1回の呼び出しにつき1枚：このチャネルでは
n=1のまま維持し、さらに画像が必要な場合は並行して呼び出してください。 - 失敗したリクエストは課金されません：パラメータエラー（422 / 400）、グループ権限の不足（503）、その他のエラーレスポンスは無料です。
usageとの照合は行わないでください：prompt_tokensは常にプレースホルダーである1000 × image countとなります。コンソールの課金記録が正式なものとなります。- さらに段階制チャージボーナスが適用されます。大量利用の法人のお客様は、専用料金について営業担当までお問い合わせください。
公式 vs リバース
APIYIはGrok Imagine向けに公式チャンネルとリバースチャンネルの両方を提供しています。これらはグループ、課金、および機能面で異なります:グループの設定
利用可能な対象
申請手順
1
WeCom サポートへの連絡
WeCom サポート またはメール（[email protected]）にて申請してください。
GrokOfficial（Grok Imagine Official） の申請である旨をお知らせください。2
ユースケースとモデレーション管理の説明
画像の用途、エンドユーザーの属性、および貴社側で実施するコンテンツ審査・人的チェックの内容の3点を含めてください。具体的であるほど、審査がスムーズに進みます。
3
承認後の Token グループの切り替え
承認されると、アカウントで
GrokOfficial が有効化されます。コンソールの Token ページ に移動し、このチャネルに使用する Token を GrokOfficial に切り替えて、課金モードを Pay-as-you-go Priority または Pay-as-you-go に設定してください。アクセス権が付与される前の状態:
GrokOfficial グループが割り当てられていない Token は、503（現在のグループに利用可能なチャネルがありません） を返します。再試行しても解決しないため、まずグループを有効化する必要があります。Pay-per-request 課金モードは使用しないでください: このチャネルは従量課金制であるため、リクエストごとの課金 Token はルーティングされず、同じく 503 が返されます。コンプライアンスに関する注意事項: アクセス権が付与された後、生成されたコンテンツに関する責任は呼び出し元に帰属します。現地の法規制を遵守し、違法なコンテンツ、他者の肖像権や知的財産権を侵害するコンテンツ、または未成年者に不適切なコンテンツを生成しないでください。一般消費者向けに配信する場合は、独自のモデレーション層を追加してください。詳細背景: 海外モデル呼び出しに関するコンプライアンス上の注意。不正利用が確認された場合、グループへのアクセス権を取り消します。
技術仕様
主要パラメータ
resolution および aspect_ratio（出力サイズ）
これらは組み合わさって出力ピクセル数を決定します。いくつかの実測結果は以下のとおりです：
誤りは明確にエラーになります: 逆方向のチャネルとは異なり、ここでのパラメータ検証は xAI に準拠しています。
resolution: "4k" や aspect_ratio: "5:7" などの範囲外の値は 422 を返し、課金されません。422 が返された場合は、まずこれら2つのパラメータのスペルを確認してください（すべて小文字: 1k / 1.5k / 2k）。quality（grok-imagine-image-2.0 のみ）
high を渡すと 400（This model only supports the following quality value(s): low, medium, auto）が返されます。low または medium のみを送信してください — auto は送信しないでください。grok-imagine-image および grok-imagine-image-quality は quality を受け取らず、モデル自体が忠実度を設定します。
n（画像枚数）
このチャネルでは常に n=1 を送信してください。一度に複数の画像を生成する場合は、複数のリクエストを並行して送信してください。レイテンシは安定しているため、同時実行数は線形にスケールします。
ベストプラクティス
1
1kで探索し、2kで仕上げる
方向性を決めるために
1kでpromptを数回実行し、その後2kで最終レンダリングを行います。grok-imagine-image-2.0をmediumかつ2Kで実行すると1分以上かかるため、試行錯誤には不向きです。2
クライアントのタイムアウトを360秒に設定する
画像APIは同期型です。タイムアウトが60秒の場合、2.0
mediumで多くの誤ったタイムアウトが発生する原因となり、クライアント側で切断されたリクエストも課金されます。3
構図にはpromptではなくaspect_ratioを使用する
このパラメーターは実際に反映されます。promptに「横構図」と記述するよりも、
aspect_ratio: "16:9"を使用する方がはるかに確実です。4
URLの結果をすぐに保存する
返却された画像リンクは、サーバー上ですぐに独自のストレージへダウンロードしてください。リンクを直接参照し続けたり、エンドユーザーにそのまま渡したりしないでください。
5
編集にはリバースチャンネルに切り替える
このチャンネルではまだ画像編集を提供していません。参照画像を基にした編集や複数画像の合成には、
/v1/images/editsをGrok Imagine Reverseで使用してください。エラーコードとリトライ
クライアント側へのアドバイス:
400 / 422は確定的なエラーです — リトライしても無意味なため、代わりにアラートを発報してください。リトライする価値があるのは429およびネットワークレベルのタイムアウトのみで、指数バックオフを用いて最大3回まで試行してください。エラーレスポンスは課金されません。FAQ
すべての呼び出しが503を返します — チャンネルがダウンしていますか？
すべての呼び出しが503を返します — チャンネルがダウンしていますか？
ほぼ確実に権限の問題です。2つの可能性があります：
- Tokenグループに
GrokOfficialがない: このチャンネルは申請に基づいて付与されます。グループ設定を参照してください。 - Tokenの課金モードがリクエスト課金になっている: このチャンネルは従量課金制であり、リクエスト課金のTokenからはルーティングできません。課金モードを
Pay-as-you-go PriorityまたはPay-as-you-goに切り替えてください。
size: 2048x2048 を渡しましたが — なぜ出力が依然として1Kなのですか？
size: 2048x2048 を渡しましたが — なぜ出力が依然として1Kなのですか？
このチャンネルは
sizeを解像度階層にマッピングしないため、画像はデフォルトの1kで生成および課金されます。代わりにresolution: "2k"を使用し、aspect_ratioでフレーミングを制御してください。画像の編集や、参照画像の受け渡しはできますか？
画像の編集や、参照画像の受け渡しはできますか？
このチャンネルは現在画像編集を提供していません。
/v1/images/generationsに参照画像を送信してもエラーは発生しませんが、参照画像は無視され、promptのみから新しい画像が生成されます。編集や複数画像の合成を行うには、Grok Imagine Reverseへのアクセスを取得してください。こちらの/v1/images/editsでは1〜4枚の参照画像を受け付けることができます。なぜ n=1 なのですか？一度に複数の画像を取得するにはどうすればよいですか？
なぜ n=1 なのですか？一度に複数の画像を取得するにはどうすればよいですか？
このチャンネルは現在、単一画像の出力のみを提供しています。複数の画像を取得するには、それぞれ
n=1を指定して複数のリクエストを並行して送信してください。ワークフロー上、1回の呼び出しで複数の画像がどうしても必要な場合は、Grok Imagine Reverse（n最大10件）をご利用ください。grok-imagine-image-2.0 は他の2つとどのように異なりますか？
grok-imagine-image-2.0 は他の2つとどのように異なりますか？
grok-imagine-image-2.0はxAIのより新しい画像モデルであり、quality階層（low / medium）が追加されています。mediumはより詳細な描写が可能ですが、低速です（2Kで約60〜80秒）。grok-imagine-imageは最も安価で、どの解像度でも料金は均一です。grok-imagine-image-qualityは解像度ごとの階層型価格設定により、より高い忠実度を提供します。まずはパイプラインをgrok-imagine-imageまたは2.0 lowで動作させ、品質の必要性に応じて上位階層に移行してください。請求内容をusageのtoken数と照合することはできますか？
請求内容をusageのtoken数と照合することはできますか？
できません。
usage.prompt_tokensは常に1000 × image countであり、実際の課金とは関係のないプレースホルダーです。このチャンネルは解像度と品質階層に応じて画像ごとに課金されます。コンソールの課金記録が正式なものとなります。公式のOpenAI SDKを使用できますか？
公式のOpenAI SDKを使用できますか？
はい。エンドポイントはOpenAI Images APIと互換性があります。
base_urlをhttps://api.apiyi.com/v1に指定し、非標準フィールドはextra_bodyに入れてください：関連ドキュメント
- Grok Imagine 公式テキスト画像生成API - Playground付きAPIリファレンス
- Grok Imagine Video - 同じグループ、テキスト動画生成および画像動画生成
- Grok Imagine Reverse - 画像1枚あたりの定額料金、編集および1回の呼び出しでの複数画像生成に対応
- 画像APIの注意事項とベストプラクティス - タイムアウト、切断、圧縮に関する一般的なアドバイス
- チャージボーナス