POST /v1/responses 和 POST /v1/chat/completions 调用。模型 ID 为 grok-4.7。Responses API 是推理、函数调用、结构化输出和图片输入的主要接口。
xAI 上游规格给出的上下文窗口为 500,000 Token,支持文本和图片输入、文本输出。
适用场景
- 长时间运行的编程和智能体任务
- 多步骤知识工作与复杂分析
- 结合文本和图片输入的视觉理解
- 函数调用或受 JSON Schema 约束的输出
快速示例
- Responses API
- Chat Completions
图片输入
使用 Responses API 的多模态消息格式传入图片 URL:推理行为
Responses 使用reasoning.effort,Chat Completions 使用 reasoning_effort:
核心请求字段
响应与流式输出
非流式请求的最终答案位于 Responses 的output[].content[].text 或 Chat Completions 的 choices[0].message.content。Responses 流式请求需要依次拼接 response.output_text.delta 事件中的文本增量。
推理 Token 数量分别见 Responses 的 usage.output_tokens_details.reasoning_tokens 和 Chat Completions 的 usage.completion_tokens_details.reasoning_tokens。多轮 Responses 会话应原样传回包含 encrypted_content 的 reasoning 条目。
API 参考
查看 Grok 4.7 的请求与响应结构。