Skip to Content
API 参考Grok / xAI 协议Responses

Grok Responses

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

该协议描述路由和调度边界，而不是另一种面向调用方的请求体格式。将官方 OpenAI SDK 的 base_url 设为 https://api.hao.ai/grok/v1 即可调用该接口。

Base URL 与端点

协议根地址：

https://api.hao.ai/grok

Responses 端点：

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

认证

通过 Bearer Token 传递 HaoAI API Key：

Authorization: Bearer <你的 HAOAI_API_KEY>

请求示例

Terminal
curl https://api.hao.ai/grok/v1/responses \
  -H "Authorization: Bearer $HAOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok/grok-4.5",
    "input": "解释 API 网关如何工作。",
    "instructions": "你是一个有帮助的技术助手。",
    "max_output_tokens": 1024
  }'

流式响应

设置 stream: true 后，服务会返回 xAI-compatible SSE 事件：

grok_responses_stream.py
stream = client.responses.create(
    model="grok/grok-4.5",
    input="写一段简短的欢迎语。",
    stream=True,
)
 
for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

续写与 WebSocket 客户端

仅当 previous_response_id 对应同一 HaoAI principal 先前创建的响应时，才可以用它继续 对话。Router 会将续写绑定到创建该响应的 Grok 上游账号；未知或属于其他 principal 的 response ID 会被拒绝，而不会改投到另一个账号。

兼容 Responses WebSocket 的接入地址为：

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

它是 HaoAI 在每个 turn 中桥接到 xAI HTTP/SSE 的入口，不代表 xAI 提供原生 WebSocket transport。

当前文本模型

模型 ID说明
grok/grok-4.5默认前沿模型，上下文窗口为 500,000 token。
grok/grok-composer-2.5-fast纯文本编程模型，上下文窗口为 200,000 token；不支持图像输入。

如需使用 Chat Completions 格式，请参考 Grok Chat Completions。

Chat CompletionsModels