OpenAI SDK 相容性



開始使用 OpenAI SDK

要使用 OpenAI SDK 相容性功能，您需要：

1. 使用官方的 OpenAI SDK
2. 變更以下內容
   • 更新您的 base URL 以指向 Claude API
   • 將您的 API 金鑰替換為 Claude API 金鑰
   • 更新您的模型名稱以使用 Claude 模型
3. 查看以下章節以了解支援哪些功能



快速入門範例

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-5",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)



重要的 OpenAI 相容性限制



API 行為

以下是與使用 OpenAI 最主要的差異：

• 函式呼叫的 strict 參數會被忽略，這表示工具使用的 JSON 不保證會遵循所提供的結構描述。若要保證結構描述的一致性，請使用原生的 Claude API 搭配 Structured Outputs。
• 不支援音訊輸入；它將被忽略並從輸入中移除
• 不支援提示快取，但 Anthropic SDK 支援此功能
• System/developer 訊息會被提升並串接到對話的開頭，因為 Anthropic 僅支援單一的初始系統訊息。

大多數不支援的欄位會被靜默忽略，而不是產生錯誤。這些都記錄在以下章節中。



輸出品質考量

如果您已經對提示進行了大量調整，它很可能是專門針對 OpenAI 進行了良好調校。請考慮使用提示最佳實務指南為 Claude 重新設計提示。



System / developer 訊息提升

OpenAI SDK 的大多數輸入都可以清楚地直接對應到 Anthropic 的 API 參數，但一個明顯的差異是 system / developer 提示的處理方式。透過 OpenAI，這兩種提示可以放在聊天對話的任何位置。由於 Anthropic 僅支援初始系統訊息，API 會取得所有 system/developer 訊息，並以單一換行符號（\n）將它們串接在一起。然後，這個完整的字串會作為單一系統訊息提供在訊息的開頭。



思考支援

您可以透過新增 thinking 參數來啟用思考。在目前的模型上，思考是自適應的，由 Claude 決定何時思考以及思考的深度，而在 Claude 5 模型上則預設啟用；手動設定的擴展思考是一種舊版模式。雖然思考可以改善 Claude 在複雜任務上的推理能力，但 OpenAI SDK 不會回傳 Claude 的詳細思考過程。若要使用完整的思考功能，包括存取 Claude 的逐步推理輸出，請使用原生的 Claude API。

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)



速率限制

速率限制遵循 Anthropic 針對 /v1/messages 端點的標準限制。



詳細的 OpenAI 相容 API 支援



請求欄位



簡單欄位



tools / functions 欄位



messages 陣列欄位



回應欄位



錯誤訊息相容性

相容層維持與 OpenAI API 一致的錯誤格式。然而，詳細的錯誤訊息不會完全相同。請僅將錯誤訊息用於記錄和除錯。



標頭相容性

雖然 OpenAI SDK 會自動管理標頭，但以下是 Claude API 支援的完整標頭清單，供需要直接使用它們的開發者參考。