存取 API

API 透過我們的網頁控制台提供。您可以使用工作台在瀏覽器中試用 API,然後在帳戶設定中產生 API 金鑰。使用工作區來分割您的 API 金鑰並根據使用案例控制支出

身份驗證

所有對 Claude API 的請求都必須包含帶有您 API 金鑰的 x-api-key 標頭。如果您使用客戶端 SDK,您將在建構客戶端時設定 API,然後 SDK 會代表您在每個請求中發送標頭。如果直接與 API 整合,您需要自己發送此標頭。

內容類型

Claude API 始終接受請求主體中的 JSON 並在回應主體中返回 JSON。您需要在請求中發送 content-type: application/json 標頭。如果您使用客戶端 SDK,這將自動處理。

請求大小限制

API 對標準端點的最大請求大小為 32 MB,包括訊息 API 和權杖計數 API。如果您超過此限制,您將從 Cloudflare 收到 413 request_too_large 錯誤。特定端點有不同的限制:

回應標頭

Claude API 在每個回應中包含以下標頭:
  • request-id:請求的全域唯一識別符。
  • anthropic-organization-id:與請求中使用的 API 金鑰關聯的組織 ID。

範例

Shell
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'