Grok Imagine Image 參數與 API 差異
瞭解 Grok 圖片模型的生成參數、參考圖片格式與編輯限制。
適用模型
| 模型 | 支援的 API |
|---|---|
| grok-imagine-image-2.0 grok-imagine-image | 建立圖片、編輯圖片 |
各模型的參數差異
2.0 的參數說明來自 xAI 文件。目前測試管道無可用的 2.0 模型,平台相容性有待驗證。
| 欄位 | 差異說明 |
|---|---|
quality | 2.0 支援 low、medium 與 auto。預設為 auto,生成時使用 low,編輯時使用 medium。使用 grok-imagine-image 時請省略此欄位。 |
aspect_ratio | 2.0 在生成與編輯時支援 21:9 與 5:2。使用 2.0 編輯多張圖片時,省略此欄位會沿用第一張參考圖片的長寬比。 |
images | grok-imagine-image 已使用兩張參考圖片實測通過。可傳入 URL 字串陣列,或包含 type: "image_url" 與 url 的物件陣列。xAI 文件列出 2.0 最多可傳入 5 張參考圖片。 |
編輯單張圖片
使用 grok-imagine-image 編輯單張圖片時,請提供可公開存取的 HTTPS 圖片網址。image 可採用以下任一格式。
| 格式 | 請求欄位 |
|---|---|
| 建議 | image: {"url":"https://example.com/input.png"} |
| 相容格式 | image: "https://example.com/input.png" |
若要直接取得圖片資料,可指定 response_format: "b64_json",並讀取 data[].b64_json。