Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
GET /v1/compliance/apps/sessions/local 可列出您組織中的所有工作階段，GET /v1/compliance/apps/sessions/local/{session_id} 可擷取單一工作階段的中繼資料，而 GET /v1/compliance/apps/sessions/local/{session_id}/messages 則傳回其逐字記錄，全部皆使用您現有的 Compliance Access Key 和 read:compliance_user_data 範圍。請參閱擷取本機工作階段。budget_reached 停止原因暫停，而不會啟動新的模型請求；變更或移除預算即可恢復執行。部署接受相同的預算設定，並套用至其啟動的每個工作階段。請參閱工作階段預算。{"type": "advisor"} 項目，並指定要諮詢的 model。請參閱為工作階段指定顧問。model 物件內設定 inference_geo，或針對單一工作階段覆寫此設定。請參閱資料駐留以了解可用的地理位置和定價。.claude/skills 中的任何技能都會在工作階段啟動時自動被發現，並在該工作階段中供代理使用。claude-opus-4-1-20250805）。在 Claude API 上對此模型的所有請求現在都會傳回錯誤。我們建議升級至 Claude Opus 5。研究人員可透過外部研究人員存取計畫申請持續存取權。GET /v1/compliance/apps/sessions/remote 可列出工作階段，而 GET /v1/compliance/apps/sessions/remote/{session_id}/messages 則傳回單一工作階段的逐字記錄，使用您現有的 Compliance Access Key 和 read:compliance_user_data 範圍。請參閱擷取遠端工作階段。claude-opus-5），相較於 Claude Opus 4.8 有階段性的重大改進。Claude Opus 5 支援 1M token 上下文視窗（預設值和最大值皆為 1M）、128k 最大輸出 token，以及預設啟用的思考功能，定價為每 MTok $5 / $25 美元，與 Claude Opus 4.8 相同。此模型可在 Claude API、Claude in Amazon Bedrock、Claude on Google Cloud 和 Claude in Microsoft Foundry 上使用。請參閱 Claude Opus 5 的新功能以了解新功能、行為變更和遷移指南，以及模型概覽以取得完整規格。high 或以下時停用思考：在 effort 為 xhigh 或 max 時使用 thinking: {"type": "disabled"} 會傳回 400 錯誤，這是相較於 Claude Opus 4.8 的重大變更。請參閱 Claude Opus 5 的新功能。low、medium、high、xhigh、max），其中 max 適用於能力至關重要的工作。mid-conversation-tool-changes-2026-07-01 Beta 標頭。fallbacks 參數現在支援 "default" 模式，該模式會依拒絕類別套用 Anthropic 建議的備援模型。伺服器端備援為 Beta 版，且 "default" 模式需要 server-side-fallback-2026-07-01 Beta 標頭。請參閱拒絕與備援。claude-opus-4-7 使用 speed: "fast" 的請求現在會傳回錯誤；與 Claude Opus 4.6 不同，這些請求不會回退至標準速度。Claude Opus 4.7 本身仍可以標準速度使用。若要繼續使用快速模式，請遷移至 Claude Opus 5 或 Claude Opus 4.8。詳情請參閱快速模式。effort 層級。在建立代理時於 model 物件內傳遞 effort。請參閱 Effort 層級以了解每個層級的作用。environment.* 事件類型和三種 memory_store.* 事件類型。您可以在不輪詢的情況下回應環境和記憶體儲存區的生命週期變更。請參閱訂閱 Webhook 中的「環境事件」和「記憶體儲存區事件」分頁。POST /v1/sessions 上傳遞 initial_events，最多包含 50 個 user.message 和 user.define_outcome 事件。非空清單會在同一呼叫中啟動代理迴圈，因此您不需要另外發送事件請求來開始工作。version 欄位現在為選填。提供此欄位可進行樂觀並行控制（不符時會傳回 409 錯誤），或省略此欄位以無條件套用更新。請參閱更新語意。GET /v1/sessions/{session_id}/threads/{thread_id}/stream 接受與工作階段層級串流相同的 event_deltas[] 查詢參數，因此您可以在模型生成子代理文字時預覽其內容。一個連線僅預覽其正在讀取的執行緒。請參閱預覽工作階段執行緒事件。/v1/experimental/generate_prompt、/v1/experimental/improve_prompt 和 /v1/experimental/templatize_prompt）將與 Workbench 一同於 2026 年 8 月 17 日淘汰。移除後，對這些端點的請求將傳回錯誤。anthropic-beta: ce-user-management-2026-07-13 Beta 標頭；成員和邀請請求不需要 Beta 標頭。具有 read:org_audit 範圍的 Admin API 金鑰也可以呼叫每個使用者管理的 GET 端點。請參閱使用者管理。cmek_preserve 事件的文件，新增了篩選範例、事件酬載範例，以及兩個保留原因代碼（policy_violation_investigation、csae_report）。文件現在也說明，無論保留是由人工審查員還是自動化安全管線啟動，都會寫入保留事件。請參閱 CMEK 內容保留。expires_at 欄位中報告每個金鑰的到期時間。請參閱驗證。agent-memory-2026-07-22 Beta 標頭，此標頭會變更列出記憶（GET /v1/memory_stores/{memory_store_id}/memories）的行為：結果會以穩定的伺服器定義順序傳回，且 order_by 和 order 參數會被忽略；depth 僅接受 0、1 或省略（其他值會傳回 400 錯誤）；且 path_prefix 必須以 / 結尾，並比對完整路徑區段而非子字串。未使用此標頭發出的分頁游標在使用此標頭時無效，因此採用此標頭時請從第一頁重新開始。在記憶體儲存區端點上，agent-memory-2026-07-22 取代 managed-agents-2026-04-01；同時發送兩者會傳回 400 錯誤。2026 年 7 月 22 日起，managed-agents-2026-04-01 標頭將採用相同的列表行為。請參閱 Beta 標頭。agent-memory-2026-07-22，而非 managed-agents-2026-04-01。如果您的程式碼在記憶體儲存區呼叫上明確傳遞 betas，請在該處將 managed-agents-2026-04-01 替換為 agent-memory-2026-07-22，而非新增第二個值。claude-sonnet-5），這是我們 Sonnet 模型系列的新一代產品，優惠價格為每 MTok $2 / $10（已於 2026 年 8 月 10 日成為標準價格）。Claude Sonnet 5 支援 1M token 上下文視窗、128k 最大輸出 token，以及與 Claude Sonnet 4.6 相同的工具和平台功能集，但 Priority Tier 除外，Claude Sonnet 5 不提供此功能。遷移時有三項行為變更：自適應思考現在預設啟用；手動擴展思考（thinking: {type: "enabled", budget_tokens: N}）已移除並會傳回 400 錯誤（此功能在 Sonnet 4.6 上已棄用）；以及將取樣參數（temperature、top_p、top_k）設定為非預設值會傳回 400 錯誤。Claude Sonnet 5 也使用新的 tokenizer，對於相同文字會產生約多 30% 的 token。確切的增加幅度取決於內容和工作負載型態。請參閱 Claude Sonnet 5 的新功能以了解詳細資訊和遷移指南。如需行為差異和模型特定的提示模式，請參閱為 Claude Sonnet 5 撰寫提示。GET /v1/sessions/{session_id}/events/stream 上使用 event_deltas[] 查詢參數選擇加入。event_start 和 event_delta 事件會在完整的 agent.message 事件到達之前，預覽代理訊息生成中的文字。GET /v1/sessions 會在 next_page 旁傳回 prev_page 游標；將其作為 page 參數傳遞即可返回上一頁。請參閱分頁。agent 並設定 type: "agent_with_overrides"，以針對單一工作階段替換模型、系統提示、工具、MCP 伺服器或技能。代理本身不會變更。injection_location 設定。此設定控制憑證的值在出口時是替換到代理的傳出請求標頭、請求主體，還是兩者皆替換。claude-opus-4-6 使用 speed: "fast" 的請求不再以快速速度或進階定價執行：這些請求會以標準速度執行、以標準費率計費，且不會傳回錯誤。回應的 usage.speed 欄位會報告所使用的速度。若要繼續使用快速模式，請遷移至 Claude Opus 4.8。詳情請參閱快速模式。claude-opus-4-7 使用 speed: "fast" 的請求將傳回錯誤。請遷移至 Claude Opus 4.8 的快速模式。詳情請參閱快速模式。/v1/organizations/tunnels 移至 Claude API 上的 /v1/tunnels。新介面使用 anthropic-beta: mcp-tunnels-2026-06-22 標頭和 workspace:manage_tunnels WIF 範圍。先前的介面在遷移期間仍可使用。請參閱 Tunnels API 參考。code_execution_20260120 的支援，這是新增 REPL 狀態持久性的程式碼執行工具版本，也是程式化工具呼叫的最低版本。若要採用此版本，請將工具的 type 設定為 code_execution_20260120；不需要 Beta 標頭。此版本可在 Claude Fable 5、Claude Mythos 5、Claude Opus 4.5 及更新版本，以及 Claude Sonnet 4.5 及更新版本上使用；請參閱模型相容性表。claude-sonnet-4-20250514）和 Claude Opus 4 模型（claude-opus-4-20250514）。在 Claude API 上對這些模型的所有請求現在都會傳回錯誤。我們建議分別升級至 Claude Sonnet 4.6 和 Claude Opus 4.8。研究人員可透過外部研究人員存取計畫申請持續存取權。code_execution_20260521，此版本在工具描述中揭露每個儲存格 90 秒的執行時間限制，讓 Claude 可以為長時間執行的儲存格規劃預算。不需要 Beta 標頭。web_search_20260318 和 web_fetch_20260318，新增 response_inclusion 參數，可從 API 回應中移除已使用的結果區塊，適用於代理式工作流程。不需要 Beta 標頭。GET /v1/environments/{id}/work 端點現已在 Claude Platform on AWS 上提供。請參閱 Claude Platform on AWS 的 IAM 動作以了解授權此端點的 GetEnvironment 動作。claude-fable-5），這是我們能力最強的廣泛發布模型，同時為 Project Glasswing 參與者推出 Claude Mythos 5（claude-mythos-5）。兩個模型預設皆支援 1M token 上下文視窗、128k 最大輸出 token，以及始終啟用的自適應思考。請參閱 Claude Fable 5 和 Claude Mythos 5 介紹以了解功能、API 變更和可用性。model: "claude-fable-5"，以在新 tokenizer 下測量您的提示。stop_reason: "refusal"。在生成任何輸出之前被拒絕的請求不會向您收費。選擇加入的 fallbacks 參數（在 Claude API 和 Claude Platform on AWS 上為 Beta 版；Message Batches API 不支援）會在另一個模型上重新執行被拒絕的請求，並以備援模型的費率計費。請參閱處理停止原因。stop_details.category 欄位現在在 Claude Fable 5 上包含 "reasoning_extraction"，當請求因違反 Anthropic 服務條款中關於逆向工程或複製模型輸出的限制而被封鎖時傳回。現有的 "cyber" 和 "bio" 類別不變。不需要 Beta 標頭。thinking: {"type": "disabled"}，且不支援手動擴展思考預算和助理預填（兩者皆傳回 400 錯誤）。請參閱從 Claude Mythos Preview 遷移至 Claude Mythos 5。thinking.display 預設為 "omitted"，與 Claude Opus 4.8、Claude Opus 4.7 和 Claude Mythos Preview 相同；設定 display: "summarized" 以接收可讀的思考摘要。原始思維鏈永遠不會傳回；在同一模型的多回合對話中，請原封不動地傳回思考區塊。請參閱 Claude Fable 5 和 Claude Mythos 5 上的思考輸出。GET /v1/compliance/activities）現已在 Claude Platform on AWS 上提供。請參閱 Claude Platform on AWS 的 IAM 動作以了解授權此端點的 ListComplianceActivities 動作。session.thread_* Webhook 事件現在包含 session_thread_id 欄位，用於識別觸發事件的多代理執行緒。LanguageModel。在 iOS 27、macOS 27、visionOS 27 和 watchOS 27（Beta 版）上，透過與 Apple 裝置端模型相同的 LanguageModelSession API 呼叫 Claude。claude-opus-4-1-20250805），預計於 2026 年 8 月 5 日在 Claude API 上淘汰。我們建議遷移至 Claude Opus 4.8。詳情請參閱模型棄用。max_tokens 參數，可限制顧問模型每次呼叫的輸出上限，為不需要完整長度顧問回應的工作負載降低延遲和輸出 token 成本。在顧問工具定義上設定 tools[].max_tokens；請參閱限制顧問輸出。stop_reason: "refusal" 且 Claude 未生成任何輸出時，您不再需要為該請求付費。請參閱串流拒絕以了解如何偵測和處理拒絕。AnthropicSelfHostedEnvironmentAccess 受管政策。messages 陣列中的使用者回合之後發送 role: "system" 訊息（須遵守放置規則），在長時間執行的工作階段中變更指令時保留提示快取命中。不需要 Beta 標頭。stop_details 欄位現已公開記錄；它會傳回 category（cyber、bio 或 null）和人類可讀的 explanation，讓您的應用程式可以將不同類別的拒絕導向正確的下一步。不需要 Beta 標頭。high，包括 Claude Code 和 Messages API。temperature、top_p 或 top_k 設定為非預設值會傳回 400 錯誤，與 Claude Opus 4.7 相同。詳情請參閱遷移指南。usage.output_tokens_details.thinking_tokens，報告計費輸出 token 中有多少是擴展思考。串流時，此細目僅出現在最後的 message_delta 事件上。不需要 Beta 標頭。agent_toolset 和 MCP 工具且超過 100K 字元（約 25K token）的大型輸出現在會自動溢出至沙箱中的檔案。模型會收到包含檔案路徑的截斷預覽，並可從該處讀取完整內容。diagnostics.previous_message_id，API 會報告 cache_miss_reason，說明提示快取前綴與上一回合的分歧位置。請在您的請求中包含 cache-diagnosis-2026-04-07 Beta 標頭。model: "claude-opus-4-7" 設定 speed: "fast" 並使用 fast-mode-2026-02-01 beta 標頭，即可以進階定價獲得顯著更快的輸出 token 生成速度。定價、速率限制和存取權限與 Opus 4.6 快速模式相同；有興趣的客戶請加入等候名單。managed-agents-2026-04-01 beta 標頭下進入公開測試版。mcp_oauth 憑證。請參閱使用保管庫進行驗證。dreaming-2026-04-21 beta 標頭限制。申請存取權限以進行試用。context-1m-2025-08-07）。該 beta 標頭現在對這些模型不再有任何作用，超過標準 200k token 上下文視窗的請求將傳回錯誤。若要使用 1M 上下文視窗，請遷移至 Claude Sonnet 4.6 或 Claude Opus 4.6，這些模型已正式支援此功能，採用標準定價且無需 beta 標頭。managed-agents-2026-04-01 標頭下進入公開測試版。請參閱使用代理記憶以取得完整的整合指南。claude-3-haiku-20240307）。所有對此模型的請求現在將傳回錯誤。我們建議升級至 Claude Haiku 4.5。/anthropic/v1/messages 的 Messages API 端點，在 27 個 AWS 區域提供全球和區域端點。task-budgets-2026-03-13 beta 標頭。xhigh effort 層級。xhigh 介於 high 和 max 之間，專為長時間執行的代理式和程式設計任務（超過 30 分鐘）調校，token 預算可達數百萬。無需 beta 標頭。claude-sonnet-4-20250514）和 Claude Opus 4 模型（claude-opus-4-20250514），Claude API 上的停用日期預定為 2026 年 6 月 15 日。我們建議分別遷移至 Claude Sonnet 4.6 和 Claude Opus 4.8。請參閱模型棄用以了解更多資訊。advisor-tool-2026-03-01。managed-agents-2026-04-01 beta 標頭。請參閱 Claude Managed Agents 概述以了解更多資訊。ant CLI，這是 Claude API 的命令列用戶端，可實現與 Claude API 更快速的互動、與 Claude Code 的原生整合，以及在 YAML 檔案中對 API 資源進行版本控制。請參閱 CLI 快速入門以了解更多資訊。/anthropic/v1/messages 的全新 Claude in Amazon Bedrock 端點使用與第一方 Claude API 相同的請求格式，並在 AWS 管理的基礎設施上執行，營運商無任何存取權限。可在 us-east-1 使用；請聯絡您的 Anthropic 客戶主管以申請存取權限。請參閱 Claude in Amazon Bedrock 以了解更多資訊。max_tokens 上限提高至 300k。包含 output-300k-2026-03-24 beta 標頭即可為長篇內容、結構化資料和大型程式碼生成任務產生更長的單輪輸出。context-1m-2025-08-07 beta 標頭對這些模型將不再有任何作用，超過標準 200k token 上下文視窗的請求將傳回錯誤。若要繼續使用 1M 上下文視窗，請遷移至 Claude Sonnet 4.6 或 Claude Opus 4.6，這些模型以標準定價支援完整的 1M token 上下文視窗，無需 beta 標頭。GET /v1/models 和 GET /v1/models/{model_id} 現在會傳回 max_input_tokens、max_tokens 和 capabilities 物件。查詢 API 以探索每個模型支援的功能。display 欄位，讓您可以從回應中省略思考內容以加快串流速度。設定 thinking.display: "omitted" 即可接收 thinking 欄位為空但保留 signature 的思考區塊，以維持多輪對話的連續性。計費方式不變。請參閱控制思考顯示以了解更多資訊。cache_control 欄位，系統會自動快取最後一個可快取的區塊，並隨著對話增長向前移動快取點。無需手動管理中斷點。可與現有的區塊層級快取控制搭配使用，以進行細粒度最佳化。可在 Claude API 和 Microsoft Foundry（預覽版）上使用。請參閱提示快取以了解更多資訊。claude-3-7-sonnet-20250219）和 Claude Haiku 3.5 模型（claude-3-5-haiku-20241022）。所有對 Claude Sonnet 3.7 的請求現在將傳回錯誤。在 Claude API 上對 Claude Haiku 3.5 的請求現在將傳回錯誤；該模型在 Amazon Bedrock 和 Google Cloud 上仍可使用。我們建議分別升級至 Claude Sonnet 4.6 和 Claude Haiku 4.5。研究人員可透過外部研究人員存取計畫申請持續存取權限。claude-3-haiku-20240307），停用日期預定為 2026 年 4 月 20 日。我們建議遷移至 Claude Haiku 4.5。請參閱模型棄用以了解更多資訊。thinking: {type: "adaptive"}）；手動思考（type: "enabled" 搭配 budget_tokens）已棄用。Opus 4.6 不支援預填助理訊息。請參閱 Claude 4.6 的新功能以了解更多資訊。budget_tokens，用於控制新模型的思考深度。inference_geo 參數指定模型推論的執行位置。2026 年 2 月 1 日之後發布的模型可使用僅限美國的推論，定價為 1.1 倍。output_format 參數已移至 output_config.format。現有的測試版使用者可在過渡期間繼續使用 beta 標頭。結構化輸出在 Amazon Bedrock 和 Microsoft Foundry 上仍為公開測試版。console.anthropic.com 現在會重新導向至 platform.claude.com。作為我們 Claude 品牌整合的一部分，Claude Console 已遷移至新位置。現有的書籤和連結將透過自動重新導向繼續運作。詳情請參閱 2025 年 9 月 16 日公告。claude-3-opus-20240229）。所有對此模型的請求現在將傳回錯誤。我們建議升級至 Claude Opus 4.5，該模型以三分之一的成本提供顯著改進的智慧。研究人員可透過外部研究人員存取計畫申請在 API 上持續存取 Claude Opus 3。tool_runner 時透過摘要自動管理對話上下文。structured-outputs-2025-11-13。clear_thinking_20251015）擴充了上下文編輯功能，實現思考區塊的自動管理。請參閱上下文編輯以了解更多資訊。skills-2025-10-02 測試版），這是擴充 Claude 能力的新方式。Skills 是包含指令、指令碼和資源的組織化資料夾，Claude 會動態載入以執行專業任務。初始版本包括：
/v1/skills 端點）上傳您自己的 Skills，以封裝領域專業知識和組織工作流程model_context_window_exceeded，讓您無需計算輸入大小即可請求最大可能的 token 數。請參閱處理停止原因以了解更多資訊。request-id 標頭並存。請參閱錯誤以了解更多資訊。claude-3-5-sonnet-20240620 和 claude-3-5-sonnet-20241022）。這些模型將於 2025 年 10 月 28 日停用。我們建議遷移至 Claude Sonnet 4.5（claude-sonnet-4-5-20250929）以獲得改進的效能和能力。請參閱模型棄用以了解更多資訊。rate_limit_error）錯誤。先前在類似情況下會發生 529（overloaded_error）錯誤。search-results-2025-06-09。請參閱搜尋結果以了解更多資訊。*Opus 4.1 不允許同時指定 temperature 和 top_p 參數。請僅使用其中一個。
text_editor_20250728，這是更新的文字編輯器工具，修正了先前版本的一些問題，並新增了可選的 max_characters 參數，讓您可以在檢視大型檔案時控制截斷長度。search-results-2025-06-09。fine-grained-tool-streaming-2025-05-14。thinking 區塊輸出的 signature 欄位中回傳。interleaved-thinking-2025-05-14。top_p 核採樣參數的預設值從 0.999 變更為 0.99，適用於所有模型。若要還原此變更，請將 top_p 設定為 0.999。
此外，當啟用擴展思考時，您現在可以將 top_p 設定為 0.95 到 1 之間的值。tool_result 和 document.source 的父層 content 區塊中指定。為了向後相容，如果在 tool_result.content 或 document.source.content 的最後一個區塊中偵測到快取控制，它將自動套用到父層區塊。在 tool_result.content 和 document.source.content 內的任何其他區塊上設定快取控制將導致驗證錯誤。tool_choice 參數中新增了 none 選項的支援，可防止 Claude 呼叫任何工具。此外，當包含 tool_use 和 tool_result 區塊時，您不再需要提供任何 tools。bash_20250124：功能與先前版本相同，但獨立於電腦使用。不需要 beta 標頭。text_editor_20250124：功能與先前版本相同，但獨立於電腦使用。不需要 beta 標頭。computer_20250124：更新的電腦使用工具，包含新的命令選項，包括 "hold_key"、"left_mouse_down"、"left_mouse_up"、"scroll"、"triple_click" 和 "wait"。此工具需要 "computer-use-2025-01-24" anthropic-beta 標頭。
請參閱使用 Claude 進行工具使用以了解更多資訊。anthropic-organization-id 回應標頭。此標頭提供與請求中使用的 API 金鑰相關聯的組織 ID。以下功能現已在 Claude API 中正式推出：
我們也發布了新的官方 SDK：
user/assistant 回合順序的限制。連續的 user/assistant 訊息將合併為單一訊息而非產生錯誤，且我們不再要求第一個輸入訊息必須是 user 訊息。tool_choice 欄位中設定 disable_parallel_tool_use: true，以確保 Claude 最多使用一個工具。請參閱平行工具使用以了解更多資訊。dangerouslyAllowBrowser: true 以啟用此功能。anthropic-beta: max-tokens-3-5-sonnet-2024-07-15 標頭，從 Claude Sonnet 3.5 產生長度最多 8,192 token 的輸出。Was this page helpful?