APIへのアクセス

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

認証

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

コンテンツタイプ

Anthropic 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

レスポンスヘッダー

Anthropic 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-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'