API 參考支援與設定

版本

Copy page



發出 API 請求時，您必須傳送 anthropic-version 請求標頭。例如，anthropic-version: 2023-06-01。如果您使用的是用戶端 SDK，這會自動為您處理。

對於 Messages API 的任何特定版本，Anthropic 會保留：

• 現有的輸入參數
• 現有的輸出參數

然而，Anthropic 可能會進行以下操作：

• 新增額外的選用輸入
• 在輸出中新增額外的值
• 變更特定錯誤類型的條件
• 為類似列舉的輸出值新增新的變體（例如，串流事件類型）

一般而言，如果您依照本參考文件所記載的方式使用 API，Anthropic 不會破壞您的使用方式。

版本歷史

Anthropic 建議盡可能使用最新的 API 版本。先前的版本被視為已棄用，且可能無法供新使用者使用。

• 2023-06-01
  • 串流「server-sent events」（伺服器傳送事件），即 SSE 的新格式：
    • 補全內容為增量式。例如，" Hello"、" my"、" name"、" is"、" Claude." 而非 " Hello"、" Hello my"、" Hello my name"、" Hello my name is"、" Hello my name is Claude."。
    • 所有事件皆為具名事件，而非僅含資料的事件。
    • 移除了不必要的 data: [DONE] 事件。
  • 移除了回應中舊有的 exception 與 truncated 值。
• 2023-01-01：初始版本。