建立圖片

此 API 沿用 OpenAI Images Generations 路徑，並支援 aspect_ratio 和 resolution 等 Grok 專屬參數。

POST/v1/images/generations

根據文字提示建立一張或多張圖片。此 API 沿用 OpenAI 風格的 POST /v1/images/generations 端點，並增加 Grok 圖片模型使用的長寬比和解析度參數。

模型 ID 範例包括 grok-imagine-image-pro 和 grok-imagine-image。請在呼叫前透過目前 API Key 的模型清單確認實際可用的模型 ID。

單次請求最多生成 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 回傳暫時圖片網址，應儘快下載或處理；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`