Grok (xAI) 文本对话

Grok 是 xAI 推出的大语言模型系列，接口完全兼容 OpenAI 格式，可零成本迁移现有 OpenAI 应用，支持最高 500k token 上下文与图像理解。

端点

POST $URL/v1/chat/completions

支持模型

模型	定位	上下文
grok-4.6	旗舰版，综合能力与速度最强	500k
grok-4.5	上一代旗舰	500k

主要参数

参数	类型	必填	说明
model	string	是	上述模型名称
messages	array	是	对话消息列表；system/user/assistant 可任意顺序混排
stream	boolean	否	是否流式返回，默认 false
temperature	number	否	采样温度 0~2
max_tokens	integer	否	最大生成 token 数
tools / tool_choice	array / string	否	Function Calling
response_format	object	否	结构化输出（如 {"type":"json_object"}）
image	string / object	否	图片输入（消息 content 中以 image 形式传入），支持 jpg/png，单张 ≤ 20MiB

请求示例

curl

curl $URL/v1/chat/completions \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="$URL/v1")
resp = client.chat.completions.create(
    model="grok-4.6",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

计费说明

• 按实际用量计费（输入 / 输出 / 缓存读分别计价），具体单价见控制台「模型广场」；
• 长上下文双档：当请求 prompt 达到 200k tokens 后，该请求的全部 token 按「长上下文档」单价计费（即使响应部分不足 200k）；
• 命中缓存读的输入 token 按折扣价计，无额外缓存写入费；
• 推理模型的思考 token 计入输出用量。

注意事项

• logprobs / top_logprobs 不支持，传入会被静默忽略；
• Grok 的知识截止于训练数据，如需实时信息请在请求中启用搜索类工具（平台按上游实际调用计费）。