Grok 模型调用

聊天选 Grok 文本模型，画图选 Grok Imagine 图片模型。 两者都使用 OpenAI 兼容地址，模型 ID 以当前密钥能获取到的列表为准。

客户端怎么填

在支持自定义 OpenAI 接口的客户端中新增提供商，填写：

字段	填什么
协议 / Provider	OpenAI Compatible
Base URL	https://api.aruhub.com/v1
API Key	自己的 AruHub 密钥
模型 ID	点击“获取模型”，选择可用的 Grok 模型

保存后发送 “回复 OK”。收到回复，并在控制台看到对应的调用记录，即可开始使用。

接到 WorkBuddy、Qoder 等 Agent 工具时，也可使用 通用 Agent 入口：https://agent.aruhub.com。

API：发送一条聊天消息

将 YOUR_API_KEY 换成密钥，YOUR_GROK_MODEL_ID 换成模型列表中的 Grok 文本模型 ID。在 macOS / Linux 终端执行：

curl https://api.aruhub.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_GROK_MODEL_ID",
    "messages": [{"role": "user", "content": "回复 OK"}],
    "stream": false
  }'

回复文字在 choices[0].message.content 中。

不知道模型 ID？先获取当前密钥可用的模型

curl https://api.aruhub.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

从返回的 data[].id 中选择 Grok 模型。聊天时选择文本模型，生成图片时选择 Grok Imagine 图片模型；两者不能混填。

用 Grok 生成图片

在支持 OpenAI Images 的图片工具中，填写同一个 Base URL，选择密钥可用的 Grok Imagine 图片模型。AruHub Studio 中可以在“设置 → 图片模型 → 新增图片模型”里选择对应的 Grok 图片模板，再填写密钥、获取并选择模型。

开发者：图片生成请求示例

将 YOUR_GROK_IMAGE_MODEL_ID 换成当前可用的 Grok 图片模型 ID，不能使用文本模型 ID。

curl https://api.aruhub.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_GROK_IMAGE_MODEL_ID",
    "prompt": "一只橘猫坐在窗边，温暖的午后阳光",
    "n": 1
  }'

若返回 data[].url，打开该地址下载图片；若返回 data[].b64_json，将内容按 Base64 解码后保存。具体返回格式和参数以当前渠道支持为准。

遇到问题

现象	检查什么
401	密钥是否正确，是否有对应分组权限
模型不存在	使用“获取模型”返回的完整 ID，不要直接填 grok
聊天正常，画图失败	是否选了图片模型，是否调用 /v1/images/generations
404	Base URL 是否只到 /v1，有无重复版本路径
想获取实时信息	模型本身是否接入联网工具，以实际渠道能力为准

接口结构参考 xAI 聊天接口说明 和 图片生成说明；本页使用 AruHub 的接入域名与密钥。