ANTHROPIC 模型指南
Claude Sonnet 5 API
Anthropic 的高速、高能力正式環境模型，適合程式開發、Agent、文件工作與工具型應用。
開發、長文件、工具代理，以及從 Sonnet 4.6 升級的正式系統。
仍依賴舊採樣設定、手動推理預算或 assistant 預填內容的整合。
選擇與整合
Claude Sonnet 5 API 費用明細
Claude Sonnet 5（claude-sonnet-5）依 token 用量計費。下方為每 1M token 的美元費率，LLMFly AI 已包含群組倍率 0.5x，不要再次套用。官方參考價格另列。資料來自網站的模型廣場快照，呼叫前請確認即時目錄與帳戶費率。
範例：10,000 個未快取輸入 token 與 1,000 個輸出 token，在 LLMFly AI 約為 $0.015。不含快取寫入、工具、重試及其他附加費。
- 平台與官方各有輸入費率區間，不要將官方長上下文倍率套用到平台價格。
- 未列價格不代表免費。快取讀取、寫入與未快取輸入，請依各自計費類別計算。
- Token 費用＝各計費類別 token 數 × 每百萬費率 ÷ 1,000,000。工具與其他費用另加。
| 價格來源 | 每次輸入 Token | 輸入 | 輸出 | 快取寫入 | 快取讀取 | 1 小時快取寫入 |
|---|---|---|---|---|---|---|
| LLMFly AI | 單一費率 | $1 | $5 | $1.25 | $0.1 | $2 |
| 官方參考價 | 單一費率 | $2 | $10 | $2.5 | $0.2 | $4 |
從 Sonnet 4.6 遷移前先看這裡
| 舊整合方式 | Sonnet 5 行為 | 必要變更 |
|---|---|---|
| 手動延伸推理預算 | 不支援 | 使用 adaptive thinking + effort |
| 非預設 temperature / top_p / top_k | 回傳 400 | 移除覆寫或使用預設值 |
| assistant 訊息預填 | 不支援 | 使用 user 訊息與明確格式限制 |
| 沿用舊 Token 預算 | 可能低估 | 重新計算 Token 並調整 max_tokens |
為何分詞器變更影響預算
- 重新計算系統提示詞、工具結構與常用文件。
- 推理 Token 與最終文字共用輸出預算。
- 同時檢查截斷率、延遲與每個任務成本。
- 在實際路徑驗證快取與用量紀錄。
設定 adaptive thinking 與 effort
Sonnet 5 預設啟用 adaptive thinking，以 effort 控制。 先以預設 high 確認品質，再測試較低 effort 能否在可接受品質下減少延遲與輸出。
- 預設上下文 1M，最多輸出 128K Token。
- adaptive thinking 預設啟用，以 effort 參數控制。
- 符合條件的平台支援工具、瀏覽器與電腦操作工具組。
- 主要為開發與 AI 代理流程設計。
適合 Sonnet 5 的正式任務
開發與代理是主要用途，仍需用自己的儲存庫、工具與失敗情境驗證。
- 正式開發、前端、程式審查與重構。
- 長文件分析與知識流程。
- 需要工具、瀏覽器互動與結構化檢查點的代理。
- 從 Sonnet 4.6 升級、希望維持 Sonnet 級延遲的團隊。
透過 LLMFly AI 呼叫 Sonnet 5
範例使用相容 OpenAI 的端點。 模型廣場若提供不同協定或路徑，請按目前 Key 可用設定測試工具、串流與錯誤。
curl https://app.llmfly.ai/v1/chat/completions \
-H "Authorization: Bearer $LLMFLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Summarize the tradeoffs in three bullets."}],
"stream": false
}'零停機遷移檢查表
- 切換正式流量前，離線重播抽樣正式請求。
- 移除不相容採樣欄位與 assistant 預填。
- 重新計算 Token、max_tokens、逾時與預算。
- 驗證 400 錯誤、工具、結構化輸出與截斷。
- 先以少量流量試行，保留回退 Sonnet 4.6 的路徑。
Sonnet 5 不相容模式
- 手動延伸推理預算已移除，請改用 adaptive thinking 與 effort。
- 非預設 temperature、top_p 或 top_k 會回傳 400 錯誤。
- 不支援 assistant 訊息預填。
- 新分詞器的 Token 數可能比 Sonnet 4.6 多約 30%；請重算提示詞並調整預算。
Claude Sonnet 5 規格來源與使用說明
遷移行為與規格已依 Anthropic Claude Sonnet 5 文件核對：https://platform.claude.com/docs/en/models/sonnet-5/whats-new-sonnet-5。 用模型廣場與小請求，確認選定 LLMFly AI 路徑的協定與工具支援。
常見問題
只改 ID 就能用 Sonnet 5 替換 Sonnet 4.6 嗎？
這樣並不穩妥。 先處理分詞器、自適應推理、採樣欄位、assistant 預填與輸出預算的差異。
為何舊 temperature 設定會報錯？
Sonnet 5 對非預設 temperature、top_p、top_k 回傳 400；請移除覆寫或使用支援的預設值。
Sonnet 5 支援手動推理預算嗎？
不是。 改用 adaptive thinking 與 effort 參數，取代手動延伸推理預算。
每個請求都比 Sonnet 4.6 便宜嗎？
只看 Token 價格無法證明。 新分詞器可能讓相同文字產生更多 Token，請比較實際用量紀錄。
如何降低遷移風險？
離線重播、重算 Token、少量流量試行，並保留驗證過的回退路徑。
用自己的任務測試 Claude Sonnet 5
建立 API 金鑰、確認模型 ID，從小量代表性請求開始。