认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行认证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY模型说明
对比现在测试环境里的 Grok 4 文档, Grok 4.6 的模型 ID 变为 grok-4.6, 仍然支持文本和图像输入, 上下文窗口为 500000, 并且提供可配置 reasoning: low, medium, high, xhigh. 默认 reasoning effort 是 high, reasoning 不能关闭.
对比 grok-4.5，主要字段变化是：新增 xhigh reasoning effort；默认 reasoning 仍为 high；上下文窗口仍为 500000。xAI 文档同时说明支持 Chat Completions 和 Responses API、function calling、web search、X search 和 code execution。
reasoning 请求里不要传 presence_penalty, frequency_penalty 或 stop, 因为上游 reasoning model 会拒绝这些参数.
参数
model string 必填
请求使用的模型 ID
值: grok-4.6
messages array 必填
表示对话历史的消息对象数组
role
string必填消息角色
可选值:
user,assistant,system,developer
content
string | array必填文本字符串或多模态内容数组. 支持文本和图像输入
reasoning_effort string
控制模型在回答前投入的推理程度. 该模型的 reasoning 不能关闭.
默认值: high
可选值: low, medium, high, xhigh
max_tokens integer
生成的最大 token 数量. 实际限制取决于当前线路和上游 response budget.
temperature number
采样温度
默认值: 1.0
范围: 0.0 - 2.0
top_p number
核采样参数
默认值: 1.0
范围: 0.0 - 1.0
stream boolean
是否增量流式返回响应
默认值: false
tools array
模型可调用的工具列表
type
string必填工具类型
可选值:
function
function
object必填函数工具定义
tool_choice string | object
控制模型如何选择工具
可选值: none, auto, required, 或指定某个 function 的对象
response_format object
模型必须输出的格式. 用于结构化输出
type
string必填输出格式类型
可选值:
text,json_object,json_schema