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，同样见该页。