Skip to Content
模型用法Grok

Grok 系列

xAI 的 Grok 模型，包括推理模型 Grok 4.7、4.6、4.5、4.3，與非推理模型 Grok 4.1 Fast、4.20。透過 OpenAI 相容介面呼叫。

常見任務

縮短推理耗時 reasoning_effort 的作用與實測效果。介面支援 Chat Completions、Responses、Anthropic 介面。錯誤排查 不支援推理參數、不支援的協定、請求逾時。

模型

完整的模型清單與即時價格請參閱模型頁 。模型 ID 的前綴為 x-ai/，可省略。

常用模型 ID（呼叫時原樣複製）
Grok 4.7x-ai/grok-4.7推理模型，500K 上下文
Grok 4.1 Fastx-ai/grok-4.1-fast非推理，2M 上下文，支援圖片
類型模型說明
推理模型Grok 4.7、4.6、4.5一律推理，耗時較長；500K 上下文，僅支援文字
推理模型Grok 4.31M 上下文，支援圖片輸入
非推理模型Grok 4.1 Fast、4.20回應快；2M 上下文，支援圖片輸入

介面支援

介面支援的模型
Chat Completions /v1/chat/completions全部
Responses /v1/responsesGrok 4.3、4.20、4.1 Fast
Anthropic 原生介面僅 Grok 4.3；其餘返回 protocol_not_supported

Grok 模型由 xAI 官方（grok）提供，部分模型另有 Azure AI Foundry 供應商。

呼叫範例

grok_basic.py
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="x-ai/grok-4.7",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
)
print(resp.choices[0].message.content)
print("推理 token:", resp.usage.completion_tokens_details.reasoning_tokens)

推理

重點Grok 4.7、4.6、4.5 一律推理，複雜問題可能耗時數分鐘。請用 reasoning_effort: low 降低推理量，或改用非推理的 Grok 4.1 Fast。
模型推理reasoning_effort
Grok 4.7、4.6、4.5一律推理low 可大幅降低推理量
Grok 4.3一律推理，不返回推理內容可傳入
Grok 4.1 Fast、4.20不推理Grok 4.1 Fast 傳入會返回 400

實測同一道數學題：Grok 4.7 預設推理約 1.5 萬 token、耗時約 4 分鐘；reasoning_effort: "low" 時約 4200 token、約 1 分鐘。推理 token 按輸出單價計費，數量見 usage.completion_tokens_details.reasoning_tokens；推理內容在串流回應的 delta.reasoning_content 中。

其他功能

  • 圖片輸入：Grok 4.3、4.20、4.1 Fast 支援，使用標準的 image_url 內容區塊，寫法見視覺理解。
  • 結構化輸出與工具呼叫：response_format 支援 json_schema；工具呼叫使用標準的 tools 參數。
  • 快取：自動快取重複的請求前綴，命中量見 usage.prompt_tokens_details.cached_tokens。

常見錯誤

HTTP · type錯誤原文原因處理方法
400 invalid_request_error包含 This model does not support 與 reasoning對非推理模型 Grok 4.1 Fast 傳入了 reasoning_effort刪除該參數
400 protocol_not_supportedModel 'x-ai/grok-4.7' does not support the 'anthropic' protocol on this platform.該模型不支援 Anthropic 介面改用 OpenAI 相容介面
400 endpoint_not_supportedModel 'x-ai/grok-4.7' does not support the /v1/responses endpoint on this platform.該模型不支援 Responses 介面改用 /v1/chat/completions
404 model_not_foundModel 'xai/grok-4.7' not found前綴寫成了 xai/前綴為 x-ai/
請求逾時—推理時間過長傳入 reasoning_effort: "low"、使用串流輸出，或將用戶端逾時設為 600 秒以上

其他通用錯誤見錯誤處理。

官方文件

常見問題

Grok 的模型 ID 怎麼寫？

標準寫法為 x-ai/grok-4.7，也可以省略前綴寫成 grok-4.7。寫成 xai/grok-4.7 會返回 404。

Grok 4.7 為什麼這麼慢？

Grok 4.7、4.6、4.5 一律推理，複雜問題可能推理上萬 token、耗時數分鐘。傳入 reasoning_effort: "low" 可大幅縮短，或改用不推理的 Grok 4.1 Fast。

Grok 能關閉推理嗎？

Grok 4.7、4.6、4.5、4.3 無法關閉推理，只能用 reasoning_effort 降低推理量。需要快速回應時請使用 Grok 4.1 Fast。

Claude Code 能用 Grok 嗎？

僅 Grok 4.3 支援 Anthropic 介面，其餘 Grok 模型呼叫時會返回 protocol_not_supported。

Grok 支援多長的上下文？

Grok 4.1 Fast 與 4.20 為 2M token，Grok 4.3 為 1M，Grok 4.7、4.6、4.5 為 500K。

最後更新於
KimiMiniMax