​
APIへのアクセス

APIは、私たちのウェブConsoleを通じて利用できます。Workbenchを使用してブラウザでAPIを試し、アカウント設定でAPIキーを生成できます。ワークスペースを使用してAPIキーを分割し、使用ケースごとに支出を制御できます。

​
認証

Claude APIへのすべてのリクエストには、APIキーを含むx-api-keyヘッダーを含める必要があります。Client SDKを使用している場合は、クライアントを構築する際にAPIを設定し、SDKがすべてのリクエストでヘッダーを代わりに送信します。APIと直接統合する場合は、このヘッダーを自分で送信する必要があります。

​
コンテンツタイプ

Claude APIは常にリクエストボディでJSONを受け入れ、レスポンスボディでJSONを返します。リクエストでcontent-type: application/jsonヘッダーを送信する必要があります。Client SDKを使用している場合、これは自動的に処理されます。

​
リクエストサイズ制限

APIには、Messages APIやToken Counting APIを含む標準エンドポイントで最大32MBのリクエストサイズ制限があります。この制限を超えると、Cloudflareから413 request_too_largeエラーが返されます。特定のエンドポイントには異なる制限があります：
  • 標準エンドポイント（Messages、Token Counting）：32MB
  • Batch API：256MB
  • Files API：500MB

​
レスポンスヘッダー

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"}
    ]
}'