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

モデル機能

Body

string
デフォルト:"grok-imagine-image-2.0"
必須
固定値:grok-imagine-image-2.0。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • true:omni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成または編集の指示。トリム後に空でないこと。最大 8,000 文字です。
integer
デフォルト:"1"
出力枚数。1~10。
string
デフォルト:"auto"
1:1、3:4、4:3、9:16、16:9、2:3、3:2、9:19.5、19.5:9、9:20、20:9、1:2、2:1、auto に対応します。
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 から呼び出してください。