読み込み中

リクエストを送信する

レッスン 315 分
読み込み中

基本的なセットアップと構造を理解していれば、Anthropic APIに初めてリクエストを送るのは簡単です。このガイドでは、Pythonを使ってClaudeにプロンプトへ応答させるために必要な基本手順を説明します。

環境のセットアップ

APIを呼び出す前に、必要なパッケージをインストールし、APIキーを安全に設定する必要があります。

まず、Jupyterノートブックに必要な依存関係をインストールします。

bash
%pip install "anthropic<1" python-dotenv

次に、ノートブックと同じディレクトリに.envファイルを作成し、APIキーを安全に保存します。

bash
ANTHROPIC_API_KEY="your-api-key-here"

この方法により、APIキーをコードの外に置くことができ、誤ってバージョン管理にコミットしてしまうことを防げます。.envは必ず.gitignoreに追加してください。

環境変数を読み込み、APIクライアントを作成します。

python
from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-haiku-4-5"

このモデルとパッケージのバージョンは、コース全体を通してそのまま使用してください。新しいバージョンでは、後のレッスンで扱うtemperatureやプリフィルされたアシスタントメッセージなどの設定が拒否されることがあります。

Create関数

APIリクエストを行う中心となるのが、client.messages.create()関数です。この関数には3つの重要なパラメータが必要です。

client.messages.create呼び出しの3つのパラメータ、model、max_tokens、messagesにそれぞれコールアウトで注釈が付けられ、下に一覧表示されている図。

  • model - 使用したいClaudeモデルの名前
  • max_tokens - 応答の長さに対する安全上の上限(目標値ではない)
  • messages - Claudeに送信する会話履歴

max_tokensパラメータは安全機構として機能します。これを1000に設定すると、Claudeはまだ話すべきことが残っていても1000トークンに達した時点で生成を停止します。Claudeはこの上限に到達しようとするわけではなく、適切だと判断した内容を書き、上限に達したら停止するだけです。

メッセージを理解する

メッセージは、チャットアプリケーションと同様に、あなたとClaudeの間の会話を表します。メッセージには2種類あります。

「量子コンピューティングとは何ですか?」と尋ねるユーザーメッセージと、それを定義するAIの返答であるアシスタントメッセージが表示されているチャットウィンドウ。

  • ユーザーメッセージ - Claudeに送信したいコンテンツ(人間が書いたもの)
  • アシスタントメッセージ - Claudeが生成した応答

各メッセージは、role(「user」または「assistant」のいずれか)とcontent(実際のテキスト)を持つ辞書です。

初めてのリクエストを送信する

Claudeにリクエストを送信する完全な例を次に示します。

python
message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

このコードを実行すると、Claudeはリクエストを処理し、生成されたテキストとリクエストに関するメタデータを含む応答オブジェクトを返します。

応答を抽出する

応答オブジェクトには多くの情報が含まれていますが、通常は生成されたテキストだけが必要です。次の方法でアクセスします。

python
message.content[0].text

これにより、次のようなきれいで読みやすい出力が得られます。「量子コンピューティングは、重ね合わせやエンタングルメントといった量子力学の原理を活用し、量子ビット(qubit)を使って情報を処理する計算の一種であり、特定の複雑な問題を古典的なコンピューターよりも指数関数的に高速に解決できる可能性があります。」

これらの基本を押さえたら、さまざまなプロンプトを試したり、Claudeとのより複雑なやり取りを構築したりし始めることができます。