GPT 參數與協定差異
了解 GPT 系列模型在 Chat Completions 與 Responses 下的參數差異與使用方式。
使用 GPT 模型時，根據本頁選擇思考檔位和工具呼叫方式。完整欄位定義參閱 Chat Completions 和 Responses。
| 模型 | 使用要點 |
|---|
| gpt-6.1-terra | 可以關閉思考，但工具呼叫仍須使用 Responses，不能因設置 none 而改用 Chat 呼叫工具 |
| gpt-6.1-sol、gpt-6-astra | 不支援關閉思考；需要較少推理時使用 low，工具呼叫使用 Responses |
| gpt-6-luna、gpt-6-sol | 可以關閉思考；Chat 函數呼叫須設置 reasoning_effort: none，需要思考與工具配合時使用 Responses |
| gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra | Chat 函數呼叫同樣須關閉思考；Responses 可保留跨輪思考，三款模型預設使用 all_turns |
| 欄位 | 差異說明 |
|---|
reasoning_effort | gpt-6.1-sol、gpt-6-astra 使用 low/medium/high/xhigh/max；其餘六款還支援 none。本頁八款均不將 minimal 列為可用檔位 |
tools | 適用限制見上表；關閉思考後可使用 Chat 的五款模型也僅呼叫用戶端工具，OpenAI 托管工具通過 Responses 使用 |
temperature、top_p | GPT-6／6.1 系列在思考檔位不是 none 時不支援，應省略；不能關閉思考的兩款模型不要攜帶。這是模型條件限制，不是欄位整體棄用 |
logprobs、top_logprobs | GPT-6／6.1 系列開啟思考時須省略；不要直接使用通用 Reference 的 Logprobs 範例 |
max_completion_tokens | 思考與最終回答共用預算。需要思考時，為兩部分一並預留輸出 Token，不只按可見回答長度設置 |
| 欄位 | 差異說明 |
|---|
reasoning.effort | 可用檔位按 Chat 表中的模型範圍選擇；使用 Responses 不會解除模型對 none 的限制 |
reasoning.mode | GPT-5.6 與 GPT-6／6.1 系列支援 standard/pro，預設 standard。pro 增加模型工作量，與思考檔位獨立，不需要更換模型 ID |
reasoning.context | GPT-5.6 三款預設 all_turns，gpt-6.1-sol 也支援該值；auto 沿用所選模型預設策略。跨輪復用須保留實際回應歷史；跨模型家族時，不兼容的思考不會沿用 |
configuration_update | GPT-6／6.1 在標準、單 Agent 模式下，可在 input 中加入此項調整後續思考深度；保持請求頂層 reasoning.effort 不變，有利於保留原提示前綴快取。不能用於 GPT-5.6 或 pro 模式 |
temperature、top_p、top_logprobs | GPT-6／6.1 系列在思考檔位不是 none 時須省略，並從 include 中移除 message.output_text.logprobs |
| 歷史 reasoning 項 | 使用 previous_response_id 延續歷史，或手動回傳完整輸入和輸出專案；store: false 時保留實際回傳的加密 reasoning 項，不把思考摘要當作原始思考回填 |
| 欄位 | 差異說明 |
|---|
prompt_cache_options.mode | 本頁八款支援 implicit/explicit；前者自動選擇可快取的消息邊界，後者按顯式斷點控制快取。最小可快取前綴為 1024 個可見輸入 Token，仍需前綴一致 |
prompt_cache_breakpoint | 在適用輸入內容區塊中標記顯式斷點。改變歷史、工具定義或輸出設定可能改變快取前綴；相同模型名稱不代表必然命中 |
prompt_cache_options.ttl | 預設 30m；Responses 還支援 12h，表示最短保留時間，不是刪除期限。不要把 Responses 的 12h 直接套入 Chat |
prompt_cache_key | GPT-5.6 及後續系列的可選快取歸屬識別碼；不是啟用快取或命中的必要條件 |
| 快取用量 | 分別查看 Token 明細中的 cached_tokens 與 cache_write_tokens，區分讀取和寫入；不以請求中啟用了快取判斷實際命中 |
將 MODEL_ID 替換為平台提供的完整模型 ID。Chat 範例不攜帶工具，Responses 範例展示結構化輸出；兩個範例均使用八款模型支援的 low 檔位。
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "用三點說明如何排查 API 逾時"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096
}'