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が含まれます。

一般提供（General Availability）:

• 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、GET /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とGoogle Cloudが含まれます。機能の利用可否と提供時期については、各プラットフォームのページを参照してください。
• 最適な用途: 既存のクラウドコミットメント、特定のコンプライアンス要件、統合されたクラウド請求



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



リクエストサイズの制限

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



レスポンスヘッダー

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

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



ページネーション

リストエンドポイントは結果をページ単位で返します。比較的新しいリストエンドポイントのほとんどは、このセクションで説明するpageとnext_pageのカーソル方式を使用します。一部は異なる方式を使用します。このセクションの最後にある注記を参照してください。limitクエリパラメータを使用してページサイズを制御し、pageクエリパラメータを使用して隣接するページを取得します。各レスポンスには、ページ間を移動するためのカーソルフィールドとともにdata配列が含まれます。

前のページに戻るには、prev_pageをpageパラメータとして渡します。最初のページにいる場合、prev_pageはnullです。すべてのリストエンドポイントがprev_pageをサポートしているわけではありません。prev_pageを返すのはGET /v1/sessionsのみです。後方ページネーションをサポートしないリストエンドポイントでは、このフィールドはnullではなくレスポンスから省略されます。リクエストの手順については、セッションの一覧表示を参照してください。

すべてのSDKは、next_pageを自動的にたどる自動ページネーションイテレータを提供します。PythonとTypeScriptでは、リスト結果を直接イテレートすることでこれを利用できます。その他のSDKは、別のメソッドを通じてイテレータを提供します。SDKの自動ページネーションは前方のみです。前のページに戻るには、レスポンスからprev_pageを読み取り、自分でpageパラメータとして渡し直してください。言語固有の詳細については、クライアントSDKを参照してください。



レート制限と利用可能性



レート制限

APIは、悪用を防止し容量を管理するために、レート制限と支出制限を適用します。制限は使用量ティアに整理されており、組織は自動的にティアに配置され、時間の経過とともに上位のティアに移行できます。各ティアには以下があります。

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

組織の現在の制限はConsoleで確認できます。より高い制限が必要な場合は、制限ページのRequest rate limit increaseを使用してください。

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



利用可能性

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



次のステップ