Skip to main content
POST
本エンドポイントは非同期方式です。送信成功後にタスク ID が返されます。タスク状態の取得をポーリングして最終結果を取得してください。image_urls を省略するとテキストから画像生成、指定すると画像編集またはマルチ画像参照になります。

モデル機能

Body

string
デフォルト:"grok-imagine-image-2.0"
必須
固定値:grok-imagine-image-2.0
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成または編集の指示。トリム後に空でないこと。最大 8,000 文字です。
integer
デフォルト:"1"
出力枚数。110
string
デフォルト:"auto"
1:13:44:39:1616:92:33:29:19.519.5:99:2020:91:22:1auto に対応します。
string
デフォルト:"1k"
1k または 2k
string
テキストから画像生成時のみ low または medium(デフォルト)。image_urls がある場合は送信しないでください。
array
参考画像 1~3 枚。公開アクセス可能な絶対 HTTP(S) URL のみ対応します。ローカル画像は先に POST /v1/uploads/images へアップロードし、返された url を使用してください。

非同期タスク

送信成功時は HTTP 202 で、タスク ID は data.id にあります。data.poll_url または GET /v1/tasks/{task_id} を使用し、completed または failed になるまで照会してください。
長期有効な API キーをブラウザーコード、公開環境変数、URL、ローカルストレージ、クライアントログに含めないでください。バックエンドまたは BFF から呼び出してください。