认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行认证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY模型说明
Grok 4.7 面向编码和知识工作进行了优化, 包括需要持续数小时运行的任务. 模型改进了自我检查、长上下文管理、文档和演示文稿生成能力, 并针对 Grok Bot harness 进行了原生训练. 模型已通过 Grok API 以及兼容的第三方路由和编程工具提供.
模型支持可配置 reasoning: low, medium, high, xhigh. 默认 reasoning effort 是 high, reasoning 不能关闭.
标准 API 价格为每百万输入 token 2 美元, 每百万输出 token 6 美元. fast 变体的输出速度翻倍, 价格也翻倍.
reasoning 请求里不要传 presence_penalty, frequency_penalty 或 stop, 因为上游 reasoning model 会拒绝这些参数.
参数
model string 必填
请求使用的模型 ID
值: grok-4.7
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