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はWeb上のConsoleを通じて利用できます。playgroundを使用してブラウザで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のレスポンスには以下のヘッダーが含まれます。

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

ページネーション

一覧取得エンドポイントは結果をページ単位で返します。新しい一覧取得エンドポイントの多くは、このセクションで説明する 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は、不正利用を防ぎキャパシティを管理するために、「rate limit」（レート制限）と支出制限を適用します。制限は使用量ティアに分類されており、組織は自動的にいずれかのティアに配置され、時間の経過とともに上位のティアに移行できます。各ティアには以下があります。

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

レート制限はConsoleのレート制限ページで、支出制限は請求ページで確認できます。より高いレート制限またはより高い月間支出上限が必要な場合は、レート制限ページのRequest rate limit increaseを使用してください。

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

提供状況

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

次のステップ