Skip to Content
API 参考SpaceXAI 协议Chat Completions

SpaceXAI Chat Completions

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

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

旧 /grok/... API 路径继续直接支持，行为与 /x-ai/... 一致，无需重定向。 请求中的旧模型 ID（如 grok/grok-4.5）仍兼容；新接入建议使用 x-ai/grok-4.5。Grok 是模型系列名称，SpaceXAI 是提供方与接口展示名称。

Base URL 与端点

协议根地址：

https://api.hao.ai/x-ai

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

https://api.hao.ai/x-ai/v1

Chat Completions 端点：

POST https://api.hao.ai/x-ai/v1/chat/completions

认证

通过 Bearer Token 传递 HaoAI API Key：

Authorization: Bearer <你的 HAOAI_API_KEY>

当前可用模型

请使用带 x-ai/ 前缀的 canonical model ID。

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

请求示例

Terminal
curl https://api.hao.ai/x-ai/v1/chat/completions \
  -H "Authorization: Bearer $HAOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/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="x-ai/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 格式时，请参考 SpaceXAI Responses API。

ModelsResponses