Skip to Content
API 参考Grok / xAI 协议Chat Completions

Grok Chat Completions

通过 HaoAI 的 Grok / xAI API 协议族调用 Grok 模型。这个 Grok / xAI 路由只会调度 Grok-family 模型和上游；文本请求与响应正文采用 xAI 的 OpenAI-compatible Chat Completions JSON / SSE 格式。

该协议描述 Grok / xAI 的路由和调度边界，并不表示它是 OpenAI 上游的别名。请使用 HaoAI API Key，而不是 xAI OAuth 凭据，并配置下面的 Grok 入口。

Base URL 与端点

协议根地址：

https://api.hao.ai/grok

使用官方 OpenAI SDK 时，请配置以下 SDK Base URL：

https://api.hao.ai/grok/v1

Chat Completions 端点：

POST https://api.hao.ai/grok/v1/chat/completions

认证

通过 Bearer Token 传递 HaoAI API Key：

Authorization: Bearer <你的 HAOAI_API_KEY>

当前可用模型

请使用带 grok/ 前缀的 canonical model ID。

模型 ID当前用途
grok/grok-4.5默认前沿通用模型，适合通用任务、编程和 Agent 工作流；上下文窗口为 500,000 token。
grok/grok-composer-2.5-fast面向 Grok Build 工作流的纯文本编程模型；上下文窗口为 200,000 token，不接受图像输入。

请求示例

Terminal
curl https://api.hao.ai/grok/v1/chat/completions \
  -H "Authorization: Bearer $HAOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok/grok-4.5",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "解释 API 网关如何工作。"}
    ]
  }'

流式响应

设置 stream: true 后，服务会以 xAI-compatible Chat Completions SSE 格式持续返回内容：

grok_stream.py
stream = client.chat.completions.create(
    model="grok/grok-4.5",
    messages=[{"role": "user", "content": "写一段简短的欢迎语。"}],
    stream=True,
)
 
for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

需要使用 xAI-compatible Responses 格式时，请参考 Grok Responses API。

ModelsResponses