APIリファレンスAPIの使用

API概要

Copy page



Claude APIで利用可能なエンドポイント、認証ヘッダー、クライアントSDK、ページネーション、レート制限、およびクラウドプラットフォームへのアクセスオプションを理解します。

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

前提条件

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

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

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

利用可能なAPI

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

• 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）

以下のAPIはベータ版です。

• Agents API: Claude Managed Agents向けに再利用可能でバージョン管理されたエージェント設定を定義します（POST /v1/agents、GET /v1/agents）
• Sessions API: マネージドクラウドサンドボックスでステートフルなエージェントセッションを実行します（POST /v1/sessions、GET /v1/sessions/{id}/events/stream）
• Environments API: エージェントセッション用のサンドボックステンプレートを設定します（POST /v1/environments、GET /v1/environments）

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

認証

各認証方法とその使用タイミングの詳細については、認証を参照してください。Claude APIへのリクエストには以下のヘッダーが含まれます。

クライアントSDKを使用している場合、SDKは認証、バージョン、content-typeヘッダーを自動的に送信します。キーが必要とする場合は、anthropic-workspace-idを自分で渡します。APIバージョニングの詳細については、APIバージョンを参照してください。

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

APIキーの取得

APIはWebConsoleを通じて利用できます。playgroundを使用してブラウザでAPIを試し、アカウント設定でAPIキーを生成できます（Claude APIキーを取得するを参照）。作成時に各キーのタイプ（キータイプを参照）とその有効期限を選択します。ワークスペースを使用して環境を分離し、ユースケースごとに支出を管理します。

クライアントSDK

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

メリット:

• 自動ヘッダー管理（認証、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は、レスポンスに以下のヘッダーを含めます。

レート制限ヘッダーについては、レート制限のレスポンスヘッダーを参照してください。各SDKで名前によってレスポンスヘッダーを読み取る例については、APIレスポンスの背後にあるワークスペースを特定するを参照してください。

ページネーション

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

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

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

レート制限と可用性

レート制限

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

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

レート制限はConsoleのレート制限ページで、支出制限は請求ページで確認できます。より高いレート制限またはより高い月間支出上限については、レート制限ページのレート制限の引き上げをリクエストを使用してください。

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

可用性

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

次のステップ