Grok

通過 HopBase 的 OpenAI 兼容協議調用 xAI Grok 的對話、推理與生圖模型,含長上下文加價、推理 Token 計費口徑與服務端工具收費。

xAI 的 Grok 模型經 HopBase 的 OpenAI 兼容協議提供。使用 https://api.hop-base.com/v1,模型 ID 以 GET /v1/models 返回的精確寫法為準——沒有登記任何別名或裸名。

Grok 視頻(grok-imagine-video-1.5)屬於另一個套餐分組,走異步任務 API,見視頻生成。

對話與推理模型

模型 ID	上下文窗口
`grok-4.6`	500K
`grok-4.5`	500K
`grok-4.3`	1M
`grok-4.20-0309-reasoning`	2M
`grok-4.20-multi-agent-0309`	2M

POST /v1/chat/completions 與 POST /v1/responses 都可用,因此 Codex CLI 和任何 OpenAI SDK 客戶端都能調通。

多智能體只支持 Responses

grok-4.20-multi-agent-0309 按 xAI 的設計只支持 Responses 協議,用 chat/completions 調會收到上游返回的明確報錯。這是該模型自身的限制,不是網關攔截,所以錯誤文案來自 xAI。

長上下文請求

單次請求的輸入超過 20 萬 Token 時算作長上下文請求。

判定基數是非緩存輸入加緩存輸入,輸出 Token 不計入。
恰好等於 20 萬不算,要再多一個 Token。
命中的請求會在用量記錄裡帶 long_context 標記,對賬時可以區分出來。

響應裡的推理 Token

Grok 是推理模型系列,兩個端點對推理 Token 的口徑不同。程序化讀取 usage 時要注意這一點。

端點	輸出字段	是否已含推理
`/v1/chat/completions`	`completion_tokens`	不含——推理單列在 `completion_tokens_details.reasoning_tokens`
`/v1/responses`	`output_tokens`	含

HopBase 原樣透傳上游響應體,所以 chat/completions 上一條回覆可能報 completion_tokens: 1 配 reasoning_tokens: 158。要得到真實輸出長度,把兩者相加;/v1/responses 上則已經包含,不要重複相加。

如果你從流式響應裡讀用量,注意這條上游偶爾會在最後的 usage 塊裡帶上恆為 0 的鏡像字段 input_tokens 與 output_tokens。HopBase 會在這種情況下用標準字段回填。

服務端工具

Grok 在一次請求中可以調用內置的服務端工具:聯網搜索、X 搜索、代碼執行、文檔搜索、文件搜索。MCP 調用打到的是你自己的遠端服務。

一次請求調用了多少次工具,會按工具類型分別記錄在用量記錄裡。

生圖模型

Grok 的生圖模型走標準 OpenAI Images 接口,不是在 chat 裡出圖。

端點	用途
`POST /v1/images/generations`	文生圖
`POST /v1/images/edits`	圖生圖,可帶參考圖

模型 ID	支持的分辨率
`grok-imagine-image`	`1k`;傳 `2k` 也會受理,按 1k 出圖
`grok-imagine-image-2.0`	`1k` / `2k`
`grok-imagine-image-quality`	`1k` / `2k`

參數

參數	說明
`prompt`	必填
`model`	必填,精確 ID
`n`	可選,默認 1
`resolution`	`1k` 或 `2k`,默認 `1k`。`4k` 會被 400 拒絕
`image`	僅 edits 使用。可傳 URL 字符串、字符串數組或 `{ "url": ... }`。最多 2 張參考圖
`mask`	不支持,傳了直接 400

響應返回圖片 URL。用 OpenAI SDK 上傳是可以的:xAI 的 edits 端點收 JSON 而不是 multipart,HopBase 會把 multipart 請求改寫成上游需要的形態。

響應形態

響應返回圖片 URL。空響應表示什麼也沒生成。生圖響應不帶 Token 用量。

curl

# 對話
curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "messages": [{ "role": "user", "content": "用五條要點總結本季度的風險。" }]
  }'

# 文生圖
curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "一隻橘貓睡在灑滿陽光的窗臺上,雜誌攝影風格",
    "resolution": "2k",
    "n": 1
  }'

分組選擇

對話與生圖由 Grok 全系分組提供,視頻由 Grok 視頻分組提供。一把密鑰只綁定一個分組,能調通對話模型的密鑰調不到視頻模型。請用實際要使用的密鑰調 GET /v1/models 確認,實際單價見登錄後的模型廣場。

本頁目錄