Grok 模型怎么通过 GrooRoute Pro 调用

通过 GrooRoute Pro 调用 Grok 模型，用的是 OpenAI 兼容的方式：base_url 填 https://grooroute.xyz/v1，请求头带平台的 API Key，model 填平台发布的 Grok 模型 ID，当前可用的见下一节。不需要另外申请 Grok 的密钥，和调用平台上其他模型是同一把 Key。价格不写在本页，实时价格与档位见模型页。

当前可用的 Grok 模型

下面是平台已发布、并且当前有供给的 Grok 模型 ID，调用时原样填进 model。右边一列是这个模型的供给声明支持的接口：

模型 ID	支持的接口
`grok-4.7`	`POST /v1/chat/completions`、`POST /v1/responses`

这份清单随平台发布的目录更新。接口一列合并了公开可用档位的声明，以接入文档页为准；标为「未声明」的模型，公开可用的档位没有声明 chat completions、messages、responses 中的任何一种，不能照本页的写法调用。每个模型在各档位的价格见模型页。

想确认你这把 Key 能用哪些模型，可以带上 Key 调用模型列表接口：

curl https://grooroute.xyz/v1/models \
  -H "Authorization: Bearer $GROOROUTE_API_KEY"

第一步：准备 API Key

export GROOROUTE_API_KEY='<your key>'

第二步：发一个请求

接口是 POST /v1/chat/completions，请求体和 OpenAI 的 chat completions 格式一样。

curl https://grooroute.xyz/v1/chat/completions \
  -H "Authorization: Bearer $GROOROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.7","messages":[{"role":"user","content":"Hello"}]}'

grok-4.7 的供给还声明了 Responses 协议，接口是 POST /v1/responses，输入放在 input 里：

curl https://grooroute.xyz/v1/responses \
  -H "Authorization: Bearer $GROOROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.7","input":"Hello"}'

用 OpenAI SDK 调用

已有的 OpenAI SDK 代码只需要改 base_url、api_key 和 model 三处。

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://grooroute.xyz/v1",
    api_key=os.environ["GROOROUTE_API_KEY"],
)

completion = client.chat.completions.create(
    model="grok-4.7",
    messages=[
        {"role": "user", "content": "Hello"}
    ],
)

print(completion.choices[0].message.content)

response = client.responses.create(
    model="grok-4.7",
    input="Hello",
)

print(response.output_text)

Node

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: "https://grooroute.xyz/v1",
  apiKey: process.env.GROOROUTE_API_KEY,
})

const completion = await client.chat.completions.create({
  model: "grok-4.7",
  messages: [{ role: 'user', content: 'Hello' }],
})

console.log(completion.choices[0].message.content)

const response = await client.responses.create({
  model: "grok-4.7",
  input: 'Hello',
})

console.log(response.output_text)

SDK 的完整说明见用 OpenAI 官方 SDK 接入。

协议和档位

上面的示例是按 grok-4.7 的供给声明的协议写的。清单里的接口合并了公开可用档位的声明；一个模型在你这把 Key 的档位上开放哪些协议，以接入文档页按 Key 和模型给出的为准；那一页也会按所选模型生成 Codex CLI、OpenCode 的配置。

同一个模型可以在经济、均衡、高质量、自营几个档位上提供，价格按档位分别标出；某个档位不提供的模型，在模型页显示为「此档位暂不提供」。

常见问题怎么排查

401：没带 API Key，或 Key 不被接受。
403：模型不在这把 Key 的分组或模型范围内，或者账户余额、Key 额度不足。
404：接口地址不对，多半是 /v1 少写或多写了一次。
503：你所在的分组当前没有这个模型可用。用 GET /v1/models 看可用模型，或在控制台换模型、换分组；刚才还能用的话一分钟后重试。

每种状态码的原文见常见报错排查，计费方式见计费说明。

常见问题

需要另外申请 Grok 的 Key 吗？

不需要。请求用的是 GrooRoute Pro 的 API Key，和调用平台上其他模型是同一把。

可用的 Grok 模型在哪里看？

本页的清单取自平台已发布且有供给的模型；也可以用你的 Key 调用 GET /v1/models，或查看模型页。

价格在哪里看？

本页不写价格数字，实时价格与档位见模型页。

最后更新：2026-10-11