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

API概要

Copy page



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

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

前提条件

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

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

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

利用可能なAPI

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

• Messages APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： 会話形式のやり取りのためにClaudeにメッセージを送信します（POST /v1/messages）
• Message Batches APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： 大量のMessagesリクエストを非同期で処理し、コストを50パーセント削減します（POST /v1/messages/batches）
• Token Counting APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： コストとレート制限を管理するために、送信前にメッセージ内のトークン数をカウントします（POST /v1/messages/count_tokens）
• Models APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： 利用可能なClaudeモデルとその詳細を一覧表示します（GET /v1/models）
• Files APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： 複数のAPI呼び出しで使用するファイルをアップロードおよび管理します（POST /v1/files、GET /v1/files）
• Skills APIAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。： カスタムエージェントスキルを作成および管理します（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はWebのConsoleを通じて提供されています。Consoleでは、Playground（platform.claude.com/playground）を使用してブラウザでAPIを試し、API キーページ（platform.claude.com/settings/keys）でAPIキーを生成できます。方法については、Claude APIキーを取得するを参照してください。各キーの種類（キーの種類を参照）と有効期限は、キーの作成時に選択します。Consoleのワークスペースを使用して、環境を分離し、ユースケースごとに支出を管理できます。

クライアントSDK

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

メリット:

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

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

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

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

Claude API

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

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

AWS、Google Cloud、またはMicrosoft Azureを通じてClaudeにアクセスします。

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

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

リクエストサイズの制限

ファーストパーティのClaude APIでは、以下のリクエストサイズ制限が適用されます。

これらの制限を超えると、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を自動的にたどる自動ページネーションイテレータを提供します。たとえば、for session in client.beta.sessions.list()はすべてのセッションを順に処理します。SDKの自動ページネーションは前方向のみです。前のページに戻るには、レスポンスからprev_pageを読み取り、ご自身でpageパラメータとして渡してください。詳細については、SDK、CLI、ライブラリを参照してください。

レート制限と可用性

レート制限

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

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

レート制限はClaude Consoleのレート制限で、支出制限はConsoleの請求ページで確認できます。より高いレート制限や月間支出上限が必要な場合は、レート制限ページのティアの引き上げをリクエストを使用してください。

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

可用性

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

次のステップ