画像を生成

この API は OpenAI Images Generations のパスを再利用し、aspect_ratio や resolution などの Grok 固有パラメーターに対応します。

POST/v1/images/generations

テキストプロンプトから 1 枚または複数の画像を生成します。この API は OpenAI 形式の POST /v1/images/generations エンドポイントを再利用し、Grok 画像モデル用のアスペクト比と解像度パラメーターを追加します。

モデル ID の例には grok-imagine-image-pro と grok-imagine-image があります。呼び出す前に、現在の API Key のモデル一覧で実際に利用できるモデル ID を確認してください。

1 回のリクエストで最大 10 枚の画像を生成できます。URL 形式の結果は一時リンクであるため、速やかにダウンロードまたは処理してください。生成コンテンツはコンテンツポリシーによりフィルタリングされる場合があります。出力画像は通常 JPG 形式です。

認証

bearerAuth

認証Bearer <token>

Authorization Header に Bearer your-api-key を指定します。

指定位置: header

リクエストボディ

application/json

Grok 画像生成のリクエストパラメーターです。

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

画像生成に使用するモデル ID です。モデルの例：

grok-imagine-image-pro：高品質で精細なシーンに適した上位画像モデル。
grok-imagine-image：汎用画像生成モデル。

実際に利用できるモデルは、現在の API Key で取得できるモデル一覧に従います。

長さ1 <= length

prompt*string

生成したい画像のテキスト説明です。

長さ1 <= length

n?integer

生成する画像数です。1～10 を指定できます。

範囲1 <= value <= 10

デフォルト値1

response_format?string

生成画像のレスポンス形式です。url は一時画像 URL を返すため、速やかにダウンロードまたは処理してください。b64_json は Base64 エンコード済み画像データを返します。

デフォルト値"url"

指定可能な値

"url"
"b64_json"

aspect_ratio?string

生成画像のアスペクト比です。省略した場合はモデルが自動的に選択します。一般的な値の例：

1:1
16:9、9:16
4:3、3:4
3:2、2:3
2:1、1:2
19.5:9、9:19.5
20:9、9:20
auto

これらは一般的な例であり、閉じた列挙型として制限するものではありません。

resolution?string

生成画像の出力解像度です。1k と 2k に対応します。

指定可能な値

"1k"
"2k"

user?string

エンドユーザーを表す一意の識別子です。監視とリスク管理に使用できます。

長さ1 <= length

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat in a tree",    "n": 1,    "response_format": "url"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`