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 确认,实际单价见登录后的模型广场。

本页目录