AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
各廠商欄位特性差異

Grok 參數與協定差異

了解 Grok 系列模型在相容協定下的參數差異與使用方式。

使用 Grok 模型時，根據本頁調整思考、採樣和快取設定。完整請求與回應結構參閱 Chat Completions 和 Responses。

適用模型

模型使用要點
grok-4.7支援 low/medium/high/xhigh，預設 high，不能關閉思考；Responses 預設回傳加密思考
grok-4.6同樣支援四檔思考，預設 high，不能關閉；需要加密思考時通過 include 請求
grok-4.5支援 low/medium/high，預設 high，不能關閉；傳入 xhigh 時按 high 處理

xAI 將 Chat 定位為舊版兼容入口，Responses 為主要接口；歷史 Messages 兼容已被官方棄用。本頁集中說明 Chat 與 Responses，不表示平台已停用其他兼容入口。

Chat Completions 差異

欄位差異說明
reasoning_effort按上表選擇檔位；不能使用 none 關閉思考
temperature請求允許 0～2，實際採樣最高為 1；高於 1 的合法值按 1 處理，不是欄位棄用
top_p合法值最高可傳 1，實際採樣不超過模型預設值，當前為 0.95；省略時使用模型預設值
presence_penalty/frequency_penalty/stop本頁思考模型不支援，傳入會回傳錯誤；不要直接套用通用 Reference 的這些可選欄位
logprobs/top_logprobs本頁三款不支援，傳入會被靜默忽略，與上方回傳錯誤的行為不同
tools[].function.strict工具參數始終嚴格遵循支援的 JSON Schema，strict 隱式為 true；不能依賴 false 切換為非嚴格生成
思考歷史Chat 不提供 Responses 的加密思考承載欄位；需要跨輪回傳加密思考時使用 Responses

Responses 差異

欄位差異說明
reasoning.effort使用本頁對應型號的思考檔位，預設 high；不能關閉思考
temperature/top_p適用上方相同的採樣上限。回應可能回顯原始請求值，不代表實際採用了高於上限的採樣值
懲罰與 Logprobs與 Chat 的限制相同：懲罰參數不支援，Logprobs 參數被忽略；不要因改用 Responses 而重新添加
max_output_tokens僅限制可見回答，不計入思考和函數呼叫 Token；省略時預設 128000，不能按 OpenAI 的合併預算含義理解
includegrok-4.6、grok-4.5 通過 reasoning.encrypted_content 請求加密思考；grok-4.7 無需顯式請求也會回傳
store/previous_response_idstore 預設 true，原廠回應保存 30 天，可通過 ID 延續。使用 store: false 時，手動回傳完整歷史及所有輸出專案，不只保留最終文字；加密思考須原樣保留
tools[].strict函數工具同樣採用隱式嚴格模式；函數參數與結構化輸出均按 xAI 支援的 JSON Schema 子集填寫
JSON SchemaadditionalProperties 預設 false，需要額外屬性時顯式設為 true；$ref/$defs 僅支援非循環引用，不能直接照搬遞歸 Schema
伺服器端工具xAI Responses 使用 web_search、x_search 和 code_interpreter 等類型；後者對應原生 xAI SDK 的 code_execution，不要混用兩套名稱

快取差異

欄位差異說明
自動前綴快取相同輸入前綴自動復用；靜態指令放在前面，後續只追加內容，不刪改或重排歷史
x-grok-conv-idChat 請求頭中的穩定工作階段識別碼，用於盡量將同一工作階段路由到持有快取的伺服器；不是模型參數
prompt_cache_keyResponses 請求體中的對應工作階段識別碼；保持每輪一致，並原樣回傳加密思考，不添加其他廠商的 TTL 或顯式斷點設定
快取用量Chat 查看 usage.prompt_tokens_details.cached_tokens，Responses 查看 usage.input_tokens_details.cached_tokens；快取可能被清除，設置工作階段識別碼不保證命中

媒體輸入差異

輸入協定內容區塊差異說明
圖片image_urlChat 的 image_url.url 接受公網 URL 或 Base64 Data URL；圖片格式為 JPEG／PNG，單圖最大 20 MiB
圖片input_imageResponses 的 image_url 直接填寫公網 URL 或 Base64 Data URL，限制同上；不要套用 Chat 的巢狀物件

三款均輸出文字。detail 可使用 auto/low/high 控製圖片處理精度，不是圖像生成參數。

呼叫範例

將 MODEL_ID 替換為平台提供的完整模型 ID，並為每個工作階段設置穩定識別碼。Responses 範例採用手動歷史管理；後續輪次需回傳完整輸出及加密思考。

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  -H 'x-grok-conv-id: YOUR_CONVERSATION_ID' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "用三點說明如何排查 API 逾時"}],
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'

官方參考

Gemini

了解 Gemini 系列模型在相容協定下的參數差異與使用方式。

Muse

了解 Muse 系列模型在相容協定下的參數差異與使用方式。

本頁目錄

適用模型Chat Completions 差異Responses 差異快取差異媒體輸入差異呼叫範例官方參考