Skip to main content
POST
本エンドポイントは別名 grok-imagine-1.5-ext にも対応します。grok-imagine-1.5-apimart と同等で相互に使用できます。

Authorizations

string
必須
すべての API は Bearer Token 認証が必要ですAPI Key の取得:API Key 管理ページ で API Key を取得リクエストヘッダーに追加:

Body

string
デフォルト:"grok-imagine-1.5-apimart"
必須
画像生成モデル名対応モデル:
  • grok-imagine-1.5-apimart - Grok 画像生成と編集(別名 grok-imagine-1.5-ext
例:"grok-imagine-1.5-ext"
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成または編集のテキスト説明
string[]
参考画像 URL リスト。指定しない場合はテキスト生成、指定すると画像編集
  • このモデルは 1~5 枚の参考画像をサポートします
  • 公開アクセス可能な絶対 http:// または https:// URL のみ対応
  • ローカル画像は先に POST /v1/uploads/images へアップロードし、返された url を使用
string
デフォルト:"1:1"
出力画像サイズ対応フォーマット:
  • 1:1 - 正方形(デフォルト)
  • 16:9 - 横長
  • 9:16 - 縦長
  • 3:2 - 横
  • 2:3 - 縦
integer
デフォルト:1
生成枚数範囲:1-10(最小 1、最大 10)⚠️ 注意: 数値はそのまま渡してください(例:1)。引用符を付けるとエラーになります

Response

integer
レスポンスステータスコード
array
レスポンスデータ配列

使用シナリオ

シナリオ 1:テキストから画像

シナリオ 2:テキストから画像(サイズと枚数)

シナリオ 3:画像編集(背景変更)

シナリオ 4:画像編集(スタイル変換)

公式モデル

grok-imagine-imagegrok-imagine-image-quality は、他の画像モデルと同じ非同期タスク方式です。送信後に返されるタスク ID を使い、タスク状態の取得で完了または失敗までポーリングしてください。
どちらのモデルにも quality を送信しないでください。image_urls を省略するとテキストから画像生成、1 枚で単一画像編集、複数枚でマルチ画像参照になります。

リクエストパラメータ

aspect_ratio の対応値:1:13:44:39:1616:92:33:29:19.519.5:99:2020:91:22:1auto

タスク送信レスポンス

202
data.id または data.poll_url を使い、状態が completed または failed になるまで照会します。