API概要

Claude APIは、https://api.anthropic.comで提供されるRESTful APIであり、ClaudeモデルおよびClaude Managed Agentsへのプログラムによるアクセスを提供します。

前提条件

Claude APIを使用するには、以下が必要です。

• Claude Consoleアカウント
• APIキー、または設定済みのWorkload Identity Federationルール

ステップバイステップのセットアップ手順については、はじめにを参照してください。

利用可能なAPI

Claude APIには以下のAPIが含まれています。

一般提供（GA）：

• Messages API：会話型インタラクションのためにClaudeにメッセージを送信します（POST /v1/messages）
• Message Batches API：大量のMessagesリクエストを非同期で処理し、コストを50%削減します（POST /v1/messages/batches）
• Token Counting API：コストとレート制限を管理するために、送信前にメッセージ内のトークン数をカウントします（POST /v1/messages/count_tokens）
• Models API：利用可能なClaudeモデルとその詳細を一覧表示します（GET /v1/models）

ベータ版：

• Files API：複数のAPI呼び出しで使用するファイルをアップロードおよび管理します（POST /v1/files、GET /v1/files）
• Skills API：カスタムエージェントスキルを作成および管理します（POST /v1/skills、GET /v1/skills）
• Agents API：Claude Managed Agents用の再利用可能でバージョン管理されたエージェント設定を定義します（POST /v1/agents、GET /v1/agents）
• Sessions API：マネージドクラウドサンドボックスでステートフルなエージェントセッションを実行します（POST /v1/sessions、GET /v1/sessions/{id}/stream）
• Environments API：エージェントセッション用のサンドボックステンプレートを設定します（POST /v1/environments、）

すべてのエンドポイント、パラメータ、レスポンススキーマを含む完全なAPIリファレンスについては、ナビゲーションに記載されているAPIリファレンスページをご覧ください。ベータ機能にアクセスするには、ベータヘッダーを参照してください。

認証

両方の認証方法の詳細とそれぞれの使い分けについては、認証を参照してください。Claude APIへのすべてのリクエストには、以下のヘッダーを含める必要があります。

クライアントSDKを使用している場合、SDKがこれらのヘッダーを自動的に送信します。APIバージョニングの詳細については、APIバージョンを参照してください。

クラウドプラットフォーム経由でClaudeにアクセスする場合、認証はクラウドプロバイダーのIAMシステムと統合されています。サポートされている認証情報の種類、必要なヘッダー、認証オプションについては、各プラットフォーム固有のドキュメントを参照してください。

APIキーの取得

APIはWeb版のConsoleを通じて利用できます。Workbenchを使用してブラウザでAPIを試し、その後アカウント設定でAPIキーを生成できます。ワークスペースを使用してAPIキーを分割し、ユースケースごとに支出を管理できます。

クライアントSDK

Anthropicは、認証、リクエストのフォーマット、エラー処理などを処理することでAPI統合を簡素化する公式SDKを提供しています。

メリット：

• ヘッダーの自動管理（x-api-key、anthropic-version、content-type）
• 型安全なリクエストおよびレスポンス処理
• 組み込みのリトライロジックとエラー処理
• ストリーミングのサポート
• リクエストタイムアウトと接続管理

クライアントSDKの一覧については、クライアントSDKを参照してください。

Claude APIとクラウドプラットフォームの比較

Claudeは、直接のClaude APIおよびクラウドプラットフォーム経由で利用できます。インフラストラクチャ、機能の利用可能性、コンプライアンス要件、価格設定の好みに基づいて選択してください。

Claude API

• 最新のモデルと機能への直接アクセス
• Anthropicによる請求とサポート
• 最適な用途： 新規統合、全機能へのアクセス、Anthropicとの直接的な関係

クラウドプラットフォームAPI

AWS、Google Cloud、またはMicrosoft Azure経由でClaudeにアクセスできます。

• クラウドプロバイダーの請求およびIAMと統合
• 機能の利用可能性はプラットフォームによって異なります： Anthropicが運営するプラットフォームにはClaude Platform on AWSとMicrosoft Foundryが含まれ、パートナーが運営するプラットフォームにはAmazon BedrockとVertex AIが含まれます。機能の利用可能性とタイミングについては、各プラットフォームのページを参照してください。
• 最適な用途： 既存のクラウドコミットメント、特定のコンプライアンス要件、統合されたクラウド請求

リクエストとレスポンスの形式

リクエストサイズの制限

これらの制限を超えると、413 request_too_largeエラーが返されます。

レスポンスヘッダー

Claude APIは、すべてのレスポンスに以下のヘッダーを含めます。

• request-id：リクエストのグローバルに一意な識別子
• anthropic-organization-id：リクエストで使用されたAPIキーに関連付けられた組織ID

レート制限と利用可能性

レート制限

APIは、不正使用を防止し、キャパシティを管理するために、レート制限と支出制限を適用します。制限は使用量ティアに分類されており、APIを使用するにつれて自動的に引き上げられます。各ティアには以下があります。

• 支出制限：API使用の月間最大コスト
• レート制限：1分あたりの最大リクエスト数（RPM）および1分あたりの最大トークン数（TPM）

組織の現在の制限はConsoleで確認できます。より高い制限やPriority Tier（コミット済み支出による強化されたサービスレベル）については、Consoleから営業担当にお問い合わせください。

制限、ティア、およびレート制限に使用されるトークンバケットアルゴリズムの詳細については、レート制限を参照してください。

利用可能性

Claude APIは、世界中の多くの国と地域で利用できます。お住まいの地域での利用可能性を確認するには、サポート対象地域のページをご確認ください。

次のステップ