GPT-5.6 API 完整教學：如何呼叫、價格、支援哪些模型

1. GPT-5.6 是什麼？和 GPT-5.5 差在哪

GPT-5.6 是 OpenAI 2026 年 2 月 16 日知識截止的 frontier 系列，面向複雜推理、Agent 編碼與多模態任務。相對 GPT-5.5，官方強調三點：

社群 benchmark 裡，GPT-5.6 Sol 在 Terminal-Bench 2.1（Agent 編碼）等指標上處於第一梯隊——但生產選型仍應以你的任務延遲、帳單和合規為準，別只看榜單。

2. 支援哪些模型？一張表看懂

能力共性（三款相同）：

• 文字 + 圖片輸入，文字輸出
• 多語言與視覺理解
• 支援 v1/responses、v1/chat/completions、v1/batch
• reasoning.effort：none / low / medium / high / xhigh / max（預設 medium）

選型一句話：

• 不確定 → 先 gpt-5.6-terra 壓測，不夠再升 Sol
• 錢比智商敏感 → Luna
• 一條請求決定公司季度方向 → Sol，必要時開 Pro 推理模式

3. GPT-5.6 endpoint：該用哪個 API？

OpenAI 目前有兩條主路徑，新功能優先 Responses API：

Base URL 均為：

https://api.openai.com/v1

認證頭（兩種 API 相同）：

Authorization: Bearer $OPENAI_API_KEY
Content-Type: application/json

GPT-5.6 endpoint 沒有單獨子網域——和普通 OpenAI API 共用 api.openai.com，區別在 請求體裡的 model 欄位。

4. 快速上手：從 API Key 到第一條回覆

4.1 開通與 Key

1. 登入 OpenAI Platform
2. Settings → API keys 建立 Secret Key（只顯示一次，務必保存）
3. Billing 綁定支付方式；GPT-5.6 按 token 後付費，無「包月無限 API」
4. 企業用戶可在組織層設 Spend limits 與 專案級 Key

環境變數（推薦）：

export OPENAI_API_KEY="sk-..."

4.2 Responses API（推薦寫法）

cURL：

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "用三句話解釋 GPT-5.6 Terra 和 Sol 的選型差異。",
    "max_output_tokens": 512
  }'

Python（官方 SDK ≥ 1.x）：

from openai import OpenAI

client = OpenAI()  # 讀取 OPENAI_API_KEY

response = client.responses.create(
    model="gpt-5.6-terra",
    input="用三句話解釋 GPT-5.6 Terra 和 Sol 的選型差異。",
    max_output_tokens=512,
)

print(response.output_text)

Node.js：

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-5.6-terra",
  input: "用三句話解釋 GPT-5.6 Terra 和 Sol 的選型差異。",
  max_output_tokens: 512,
});

console.log(response.output_text);

4.3 Chat Completions（相容舊程式碼）

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "Hello, GPT-5.6!"}
    ],
    "max_tokens": 256
  }'

遷移時把 model 從 gpt-5.5 改成 gpt-5.6-sol / terra / luna 即可；回應結構不變。

4.4 串流輸出（SSE）

Responses API 加 "stream": true，適合聊天 UI 與長回答：

stream = client.responses.create(
    model="gpt-5.6-luna",
    input="寫一首關於雲原生的五言絕句。",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

Chat Completions 側對應 stream=True，解析 choices[0].delta.content。

5. 核心參數：reasoning、工具與多模態

5.1 推理深度：reasoning.effort

控制模型「想多久」——越深，延遲和 token 消耗通常越高：

省略時 GPT-5.6 預設 medium。

5.2 Pro 模式：reasoning.mode

GPT-5.5 時代要換 gpt-5.5-pro 模型；GPT-5.6 改為在同一 slug 上開關 Pro：

{
  "model": "gpt-5.6-sol",
  "input": "設計一個支援多租戶的訂單服務 API，給出路由與資料模型。",
  "reasoning": {
    "mode": "pro",
    "effort": "high"
  },
  "max_output_tokens": 4096
}

• 計費：仍按所選 Sol/Terra/Luna 的 token 單價，但 Pro 模式會做更多內部推理工作，總 token 往往更高
• 不要再去找 gpt-5.6-pro 這類 slug（不存在）

5.3 圖片輸入（多模態）

三款 GPT-5.6 均支援 vision。Responses API 範例：

{
  "model": "gpt-5.6-terra",
  "input": [
    {
      "role": "user",
      "content": [
        {"type": "input_text", "text": "這張架構圖裡有哪些單點故障？"},
        {"type": "input_image", "image_url": "https://example.com/diagram.png"}
      ]
    }
  ]
}

也可傳 base64 內聯圖（適合私有部署鏈路）。

5.4 工具呼叫（Function / Tools）

Agent 場景在 Responses API 的 tools 欄位宣告函式或內建工具（如 web_search、file_search），模型回傳 tool_calls 後由你的服務執行並回傳結果——與 GPT-5.5 流程類似，但 GPT-5.6 在複雜工具鏈上更穩。具體 schema 見 Responses API 工具文件。

6. GPT-5.6 pricing：完整價格表（2026）

以下為 OpenAI 官方 每百萬 tokens 標價（美元）；短上下文指輸入 ≤ 272K tokens，超出進入 長上下文檔。

6.1 標準（短上下文）

6.2 長上下文（輸入 > 272K）

6.3 帳單估算範例

假設一次 Terra 呼叫：20K 輸入 + 2K 輸出，且未命中快取：

輸入：20,000 / 1,000,000 × $2.50 = $0.05
輸出：2,000 / 1,000,000 × $15.00 = $0.03
合計 ≈ $0.08 / 次

若日呼叫 1 萬次類似請求 → 約 $800/天。這就是為什麼 Luna + 快取 + 批次處理 對高併發產品至關重要。

6.4 其他費用因素

在控制台 Usage 頁按 model 分組查看，比背公式更可靠。

7. 場景選型：該用 Sol、Terra 還是 Luna？

和 ChatGPT 訂閱的關係： ChatGPT Plus/Pro 是產品訂閱，和 API 按 token 計費是兩條線。你在 App 裡用的 GPT-5.6 ≠ 自動包含 API 額度，開發整合必須單獨開 API 帳單。

8. 從 GPT-5.5 / GPT-4.1 遷移清單

1. 改 model 字串：gpt-5.5 → gpt-5.6-sol（或 terra/luna）
2. Pro 邏輯：刪除 gpt-5.5-pro，改為 reasoning.mode: "pro"
3. 調低 max_output_tokens：GPT-5.6 更緊湊，先減 20% 做 A/B
4. 回歸測試：同一 prompt 集對比品質、延遲、美元/請求
5. 監控快取命中率：固定 system prompt 的 Agent 務必開 caching
6. SDK 版本：確保 openai Python 套件 ≥ 支援 Responses API 的版本

9. 常見錯誤與排查

10. 七步落地清單（今天就能跑通）

1. 在 Platform 建立 API Key，設月度 hard limit（例如 $50）。
2. 用 Terra 跑一條 Responses API 冒煙測試。
3. 把生產 model 從 gpt-5.5 改成 gpt-5.6-terra，觀察一週帳單。
4. 對固定 system prompt 開啟 Prompt Caching，看輸入成本是否下降。
5. 難任務單獨路由到 Sol，並限制 QPS。
6. 離線評測走 Batch API。
7. 在儀表板按 model × endpoint 做成本告警。

11. 總結

GPT-5.6 API 在 2026 年的正確打開方式是：

• Endpoint：優先 v1/responses，相容用 v1/chat/completions
• 模型：sol 最強、terra 日常、luna 海量；gpt-5.6 = Sol
• 價格：Sol $5 / $30（百萬 input/output tokens）起，Terra 半價，Luna 約五分之一
• 參數：reasoning.effort 控深度；要 Pro 能力用 reasoning.mode: "pro"，別換 phantom 模型名

先 Terra 壓測、Sol 兜底、Luna 掃量，再配合快取與 Batch，比一上來全站 Sol 更可持續。

參考與延伸閱讀

• OpenAI Models 文件
• OpenAI Pricing
• GPT-5.6 Model guidance
• ChatGPT Work 免費與付費區別（產品訂閱 vs API 計費）
• MCP 2026：AI 通用 USB 介面（給 GPT-5.6 Agent 接資料源）