メインコンテンツへスキップ
POST
Text-to-image: generate images from a text prompt
🔒 デフォルトでは未開放: Grok Imagine 2 は Default グループには含まれていません。独自の**Grok_imagine_Reverseグループ**に属しており、呼び出し(このページのPlaygroundを含む)を行う前にアクセスの申請が必要です。申請がない場合、すべての呼び出しで 503 が返されます。このファミリーのコンテンツ安全ポリシーはプラットフォーム上の他のモデルと大幅に異なり、一部のカテゴリはフィルタリングされないため、コンプライアンスリスクを制限する目的で選択的にアクセスを付与しています。累計利用額が $1,000+ の既存のお客様は、サポートにユースケースを説明することで有効化できます。それ以外のお客様は、ユースケースおよび導入済みのコンテンツモデレーション管理体制の説明を添えてWeComサポートから申請してください。全手順: Grok Imagine 2 概要 - グループ設定。
右側のインタラクティブなPlaygroundを使用すると、エンドポイントを直接テストできます。Authorization に API Key を入力し(形式: Bearer sk-xxx)、prompt を記入し、aspect_ratio / resolution を選択して送信してください。
このページを使用するケース: プロンプトのみからのテキストから画像生成(画像のアップロードは含みません)。既存の画像を編集したり複数枚を合成したりする場合は、画像編集エンドポイントを使用してください。
⚠️ このエンドポイントに参照画像を送信しないでくださいここに image / image_url / images を渡してもエラーは発生しません。200 が返され、プロンプトからまったく新しい画像が生成されます — 参照画像は暗黙的に破棄され、課金は通常通り行われます。エラーシグナルが出ないため、これは通常、出力が入力とまったく関係がないことに誰かが気付いたときに初めて顕在化します。参照画像を使用するワークフローでは、必ず /v1/images/edits を使用してください。
⚠️ 無効なパラメータはエラーを発生させません無効な aspect_ratio(例: 5:7)、resolution(例: 1K、1024x1024)、response_format(例: base64)は、すべて暗黙的にデフォルト値へフォールバックし、画像が返されます。出力が期待と一致しない場合は、まずパラメータのスペルを確認してください — resolution の値は小文字の 1k / 2k であることに注意してください。1つの例外として、resolution: "4k" は 503 model_service_unavailable を返します。これはそのティアがサポートされていないことを意味し、チャンネルがダウンしているわけではありません。再試行しても解決しません。
すべての画像APIは同期処理です: 非同期タスクIDは存在しないため、クライアントが切断されると、リクエストに対して課金されたまま結果が失われます。1Kは約9秒、2Kは約15〜17秒かかるため、クライアントのタイムアウトを360秒に設定してください — 詳細は 画像APIベストプラクティス を参照してください。

コード例

Python (OpenAI SDK)

Python (生の requests)

cURL

Node.js (ネイティブ fetch)

ブラウザー JavaScript

パラメータリファレンス

アスペクト比ごとの実際の出力ピクセル数:
seed はサポートされていません(エラーなく受け付けられますが、効果はありません — 結果は再現できません)。マスクによる inpainting もサポートされていません。size / quality / style のような OpenAI 形式のフィールドは、黙って無視されます。

レスポンス形式

レスポンスフィールドの注意点
  • 各 data[] エントリには、response_format に応じて url または b64_json のどちらか一方が含まれます — 両方が含まれることはありません。
  • revised_prompt は返されず、respect_moderation / model も返されません。存在すると想定しないでください。
  • b64_json は data:image/...;base64, プレフィックスのない生の base64 です — そのままデコードしてください。
  • created は常に 0 であり、タイムスタンプとしては使用できません。
  • n > 1 では、data 配列に複数のエントリが入ります — data[0] だけを読まないでください。
usage は照合には使用できません: prompt_tokens は実際の prompt の長さにかかわらず常に 1000 x n です。このシリーズは画像ごとの定額料金($0.02 / $0.045)で課金されます。実際の請求額は APIYI Console の課金記録を参照してください。

承認

Authorization
string
header
必須

API Key created in the APIYI Console

ボディ

application/json
model
enum<string>
デフォルト:grok-imagine-image
必須

Model ID. The quality variant delivers higher fidelity at a higher price

利用可能なオプション:
grok-imagine-image,
grok-imagine-image-quality
prompt
string
必須

Prompt, English or Chinese. Describe subject, scene, style and lighting in detail

例:

"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"

n
integer
デフォルト:1

Number of images, 1-10. Values of 11 or above return 400; 0 is silently treated as 1

必須範囲: 1 <= x <= 10
例:

1

aspect_ratio
enum<string>
デフォルト:1:1

Output aspect ratio. Actual pixel dimensions per resolution tier:

Values outside this enum do not raise an error — they silently fall back to 1:1.

利用可能なオプション:
1:1,
16:9,
9:16,
4:3,
3:4
例:

"16:9"

resolution
enum<string>
デフォルト:1k

Resolution tier. 1k is roughly 0.9-1.05 megapixels and returns JPEG; 2k is roughly 4.2-4.5 megapixels and returns PNG (5-6 MB per image). Both tiers cost the same.

4k returns 503; other invalid values (such as 1K or 1024x1024) silently fall back to 1k.

利用可能なオプション:
1k,
2k
例:

"1k"

response_format
enum<string>
デフォルト:url

Response format. url returns a direct image link (no signed query params); b64_json returns a raw base64 string (without the data: prefix).

Invalid values silently fall back to the default url.

利用可能なオプション:
url,
b64_json
例:

"url"

レスポンス

Images generated successfully

created
integer

Creation timestamp. Always 0 for this model — do not use it for timing

例:

0

data
object[]

Array of image results, length equals the requested n

usage
object

Placeholder values — do not use for billing reconciliation. prompt_tokens is always 1000 x n, regardless of actual prompt length. Use the Console billing records instead.