跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Grok 4.6 API

POST Base URL: https://api.hiapi.ai /v1/chat/completions

该模型使用兼容 OpenAI 的 Chat Completions 接口。同一个 HiAPI API Key 可调用账户分组内已开放模型；切换到图片、视频或音频模型时，需要改用 /v1/tasks 及对应请求结构。

模型概览

模型名称Grok 4.6
提供方xAI
输入 / 输出文本 / 文本
接口POST /v1/chat/completions
价格HiAPI 实时 Token 价格

xAI Grok 4.6 通过 HiAPI Chat Completions 提供文本输入与文本输出、流式响应、工具调用、JSON 对象和四档已验证推理强度。

生产建议

已验证契约
  • 使用 model=grok-4.6 调用 POST /v1/chat/completions。同一个 HiAPI API Key 可调用已开放模型；媒体模型使用不同请求结构的 POST /v1/tasks。
  • 推理强度为 low、medium、high、xhigh，默认 high。推理 Token 按输出计费。
  • 首期公共契约不承诺 Responses、图片输入、并行工具或完整 structured output。超过 200K 上下文以实时模型页和长上下文验收结果为准。

适用场景

推理与工具工作流

使用 Chat Completions 构建文本 Agent、流式回答、JSON 对象和函数工具。

messagesreasoning_efforttools

请求参数

model string 必填

固定填写这个公共模型 ID。

示例 grok-4.6 可选值: grok-4.6
messages array 必填

按顺序传入 system、user、assistant 和 tool 消息。

stream boolean 可选

设为 true 返回 SSE。

默认 false
reasoning_effort enum 可选

推理强度。推理 Token 计入输出 Token。

默认 high 可选值: lowmediumhighxhigh
response_format object 可选

使用 type=json_object 请求 JSON 对象输出。

示例 {"type":"json_object"}
tools array 可选

兼容 OpenAI 的函数定义。

tool_choice string | object 可选

按需使用 auto 或 required。

API 接入示例

调用示例

流式响应

读取 content 和 reasoning_content 增量直到 [DONE]。

请求体
{
  "model": "grok-4.6",
  "messages": [
    {
      "role": "user",
      "content": "请用三段简短文字解释 HTTP 缓存。"
    }
  ],
  "stream": true,
  "reasoning_effort": "high"
}
JSON 对象

使用 response_format.type=json_object，并解析 message.content。

请求体
{
  "model": "grok-4.6",
  "messages": [
    {
      "role": "user",
      "content": "Return a JSON object with an answer field."
    }
  ],
  "stream": false,
  "reasoning_effort": "medium",
  "response_format": {
    "type": "json_object"
  }
}
函数工具

执行返回的调用，再带回 assistant 工具调用和对应的 role=tool 结果继续请求。

请求体
{
  "model": "grok-4.6",
  "messages": [
    {
      "role": "user",
      "content": "Check order A-123."
    }
  ],
  "stream": false,
  "reasoning_effort": "low",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_order_status",
        "description": "Look up an order.",
        "parameters": {
          "type": "object",
          "properties": {
            "order_id": {
              "type": "string"
            }
          },
          "required": [
            "order_id"
          ],
          "additionalProperties": false
        }
      }
    }
  ],
  "tool_choice": "auto"
}

响应结构

非流式响应遵循 Chat Completions 结构。思考模式会额外返回 reasoning_content；计费明细以 usage 为准。

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "grok-4.6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "缓存可以减少重复请求的传输成本。",
        "reasoning_content": "先梳理缓存命中条件。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 18,
    "total_tokens": 42
  }
}
  1. 从 choices[0].message.content 读取文本，按需读取 reasoning_content。
  2. 流式调用拼接 choices[0].delta.content 与 reasoning_content，直到 [DONE]。
  3. 读取 prompt、completion 和 total Token 用量；推理计入 completion Token。

常见问题

应该使用哪个接口和模型 ID？

使用 POST /v1/chat/completions，并将 model 设置为 grok-4.6。

支持哪些推理强度？

使用 reasoning_effort=low、medium、high 或 xhigh，默认 high。推理 Token 计入输出 Token。

支持流式、JSON 对象和工具调用吗？

支持。stream=true 返回 SSE，response_format.type=json_object 请求 JSON 对象，tools/tool_choice 用于函数调用。工具续轮需带回 assistant 工具调用和匹配的工具结果。

支持图片输入和 Responses 吗？

它们不属于首期 HiAPI 公共契约，请使用 Chat Completions 的文本 messages。

Token 如何计费，长上下文如何处理？

输入、输出和缓存输入按模型页与定价页的实时费率计费；推理 Token 计入输出。提供方资料提到 500K 上下文，但 HiAPI 首期在超过 200K 完成长上下文验收前不公开承诺该范围。

可以复用 OpenAI SDK 客户端吗？

可以。将 base_url 设为 https://api.hiapi.ai/v1，使用 HiAPI API Key，通过 chat.completions.create 传入 messages。

下一步