Grok

項目	填寫值
Base URL	`https://api.hop-base.com/v1`
對話	`POST /v1/chat/completions`
Responses	`POST /v1/responses`
生圖	`POST /v1/images/generations`

模型 ID 以 GET /v1/models 返回的精確寫法為準，沒有登記任何別名或裸名。

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": "用五條要點總結本季度的風險。"
    }]
  }'

對話與推理模型

模型 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 對任何 OpenAI SDK 客戶端都可用。Codex CLI 不能直接用 Grok：它會帶上 namespace 類型的工具，模型服務在生成之前就以 422 拒絕。/v1/responses 上的 previous_response_id 會被刪除、store 固定為 false，每輪請發送完整 input。

422 Failed to deserialize the JSON body into the target type: tools[<n>].type: unknown variant `namespace`

對話與生圖由「Grok 全系」分組提供，影片由「Grok 影片」分組提供。密鑰還須包含「Grok 影片」分組才能調影片模型，一把密鑰可以同時包含兩個分組；請用實際要使用的密鑰調 GET /v1/models 確認。

多智能體也能用 Chat 調用：

xAI 只透過 Responses 提供 grok-4.20-multi-agent-0309。HopBase 會把 chat/completions 請求自動轉成 Responses，返回標準的 Chat Completions 格式，串流與非串流都可以。該模型暫不支援客戶端函式工具（tools），兩個端點上帶上都會收到 xAI 的 400。

請求參數

兩個端點通用。網關只攔截 Chat Completions 的空 messages、不對下列參數設上限；標「官方」的限制出自 xAI 推理模型文件與 API 參考。

參數	必填	類型與限制	預設值	說明
`model`	必填	上表五個 ID 之一	—	精確匹配，無別名
`messages` / `input`	必填	Chat 用非空 `messages`，Responses 用 `input`	—	空 `messages` 由網關返回 400
`max_tokens` / `max_output_tokens`	選填	整數；網關不設上限，受上下文窗口約束	Responses 官方預設 128,000	官方口徑含推理 Token
`temperature`	選填	數值 0–2（官方）	服務預設	數值越高輸出越多樣
`top_p`	選填	數值 0–1（官方）	服務預設	官方建議與 `temperature` 二選一
`reasoning_effort`	選填	取值見下方	`high`	推理無法關閉
`tools`	選填	函式工具與服務端工具	—	服務端工具按次計費
`stream_options.include_usage`	選填	布林	`false`	Chat 串流下要收到 `usage` 必須設 `true`

reasoning_effort 官方只對兩個型號開放:

grok-4.6：low / medium / high / xhigh。
grok-4.5：low / medium / high。
grok-4.20-multi-agent-0309 用 reasoning.effort（Chat Completions 上寫 reasoning_effort），它控制協作的智能體數量。

官方不支援 presence_penalty、frequency_penalty、stop，推理模型傳了會報錯。grok-4.20 及更新型號也不支援 logprobs、top_logprobs，不回傳 token 對數機率，請不要傳。

完整字段見 API 參考 · Chat Completions，在模型種類裡選 Grok。

計費與用量

長上下文請求

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

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

推理 Token

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

端點	輸出字段	是否已含推理
`/v1/chat/completions`	`completion_tokens`	不含
`/v1/responses`	`output_tokens`	含

Chat Completions 把推理單列在 completion_tokens_details.reasoning_tokens。HopBase 原樣透傳 xAI 的響應體，所以一條回覆可能報 completion_tokens: 1 配 reasoning_tokens: 158。

要得到真實輸出長度，把兩者相加；/v1/responses 上則已經包含，不要重複相加。

服務端工具

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

一次請求調用了多少次工具，會按工具類型分別記錄在控制台「使用記錄」裡。實際單價見登入後的模型廣場。

生圖模型

Grok 生圖模型 grok-imagine-image、grok-imagine-image-2.0、grok-imagine-image-quality 走標準 OpenAI Images 介面，只支援同步調用。文生圖用 POST /v1/images/generations，圖生圖用 POST /v1/images/edits。

畫幅用 aspect_ratio、檔位用 resolution，沒有 size。完整參數、實測出圖尺寸與計費維度見 Grok Imagine 圖片與影片。

Grok 影片(grok-imagine-video-1.5)屬於「Grok 影片」分組，走非同步任務 API，同樣見該頁。