Grok Imagine 生圖

Grok Imagine 生圖只支援同步調用，一次請求直接返回圖片的臨時下載連結。

可用型號

三個型號的請求參數完全相同，只是單價不同。

請求參數

生成

quality、aspect_ratio、n 由模型校驗，閘道不查。grok-imagine-image-quality 是一個模型 ID，不是 quality 欄位的取值。

size 是 GPT Image 的參數，Grok 生圖不用它：畫幅由 aspect_ratio 決定，像素檔位由 resolution 決定。從 GPT Image 遷過來時，刪掉 size，並把 quality 改成上面三個取值之一。

編輯

/v1/images/edits 在生成參數之外，用 image 傳參考圖：

• image 可以是 URL 字串、字串陣列或 { "url": ... }。
• 每張是公開 HTTP(S) URL 或完整 Data URL（data:image/png;base64,…）。
• 不接受裸 base64、asset://、file_id。
• 用 OpenAI SDK 上傳本機檔案也可以：multipart 單張 image 或重複 image[] 檔案。

curl https://api.hop-base.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "把背景換成黃昏的海邊，保留主體",
    "image": ["https://example.com/source.png"],
    "aspect_ratio": "3:2",
    "resolution": "1k"
  }'

畫幅與實際出圖尺寸

aspect_ratio 定形狀，resolution 定像素總量：1k 約 100 萬像素，2k 約 400 萬像素。下表是 grok-imagine-image 在 resolution: 1k 下的實測出圖尺寸：

9:19.5、20:9、9:20 同樣是合法取值，上表未列它們的實測尺寸。resolution: 2k 保持同一形狀、放大像素總量，例如 16:9 出 2816×1584、1:1 出 2048×2048。

回應結果

回應範例（URL 為佔位符，其他 metadata 省略）：

{
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

收到後請立即下載保存。回應不帶 token 用量；空回應表示沒有生成圖片，不要把空 data 當成功。

範例

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "一隻橘貓睡在灑滿陽光的窗台上，雜誌攝影風格",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

aspect_ratio 與 resolution 不是 OpenAI SDK 的內建參數，Python 裡放進 extra_body。

注意事項

• 只支援同步：不支援流式，請勿傳送 Prefer: respond-async header。
• 生圖的 resolution 只有 1k 與 2k，沒有 4K 檔位，也不能填影片的 480p / 720p / 1080p。
• 返回的 URL 是臨時連結，收到後請立即下載保存。
• 編輯最多 2 張參考圖，這是 HopBase 的生圖編輯限制，不適用於影片參考圖。
• 生圖與影片是兩個分組、密鑰不通用，影片見 Grok Imagine 影片。

常見報錯

n、quality、aspect_ratio 超出範圍時由模型自行拒絕並返回其訊息。圖片請求失敗時檢查 HTTP 狀態及 error。

計費

按出圖張數 × resolution 檔位計費，與像素寬高無關；/v1/images/edits 的每張參考圖另計一筆，內容審核拒絕不計費。grok-imagine-image 傳 2k 也會出圖，按 1k 檔單價計。

回應裡的 usage.cost_in_usd_ticks 不是你的扣費，實際扣費以控制台「使用記錄」為準。各檔單價見上表模型卡，你的實際單價以模型廣場為準。

下一步

• 圖片總覽：各生圖系列的對比與通用規則
• GPT Image、Gemini 生圖、Seedream：其他生圖系列
• Grok Imagine 影片：Grok 影片任務的提交與輪詢
• API 參考：生成圖片、編輯圖片
• 故障排查：請求失敗時按症狀排查