AWS Bedrockへの最初のAPIリクエストを行うには、3つの必須要素が必要です。サービスに接続するためのBedrock Runtime Client、実行したいモデルを指定するModel ID、そしてモデルに与えたいテキストを含むUser Messageです。
Bedrockクライアントの設定
クライアントはすべてのリクエストにAWS認証情報で署名するため、開始前にこれらを設定しておく必要があります。AWS CLIをインストールし、aws configure、またはAWS CLI認証情報に関するAWSガイド(新しいタブで開きます)に記載されている他の方法で認証情報を設定してください。認証情報がない状態では、最初のリクエストはNoCredentialsErrorで停止します。
pip install boto3でboto3をインストールします。次に、Bedrockランタイムサービスに接続するためのクライアントを作成します。
import boto3
client = boto3.client("bedrock-runtime", region_name="us-west-2")Model IDとリージョンごとの利用可否の理解
ここでつまずきやすいポイントがあります。すべてのモデルがすべてのAWSリージョンで利用できるわけではありません。選択したリージョンに存在しないモデルを実行しようとすると、モデルが存在しないという分かりにくいエラーメッセージが表示されます。

例えば、Claude Sonnetがus-west-2で利用可能であっても、us-east-1からリクエストを送信している場合、そのリクエストは失敗します。

推論プロファイルの使用
推論プロファイルは、選択したモデルが実際にホストされているリージョンへリクエストを自動的にルーティングすることで、リージョンごとの利用可否の問題を解決します。

どのリージョンにどのモデルがあるかを追跡する代わりに、モデルがus-west-2やus-east-2など複数のリージョンで利用可能であることを把握している推論プロファイルを使用できます。

推論プロファイルを使用してリクエストを行うと、別のリージョンから接続している場合でも、AWSが自動的にモデルが存在する正しいリージョンへそのリクエストをルーティングします。
推論プロファイルIDを見つけるには、AWS Bedrockコンソールに移動し、メインのモデルカタログページのモデルIDを使用するのではなく、「クロスリージョン推論(Cross-region inference)」の下を確認してください。

選択したモデルの推論プロファイルIDをコピーします。このコースの例ではClaude Haiku 4.5を使用しており、その推論プロファイルIDはus.anthropic.claude-haiku-4-5-20251001-v1:0です。
model_id = "us.anthropic.claude-haiku-4-5-20251001-v1:0"User Messageの作成
User Messageには特定の構造があり、最初は過度に複雑に見えるかもしれませんが、そうなっているのには正当な理由があります。
user_message = {
"role": "user",
"content": [
{"text": "What's 1+1?"}
]
}contentがリストになっているのは、1つのメッセージにテキスト、画像、その他のメディアタイプなど、異なる種類のコンテンツを含めることができるためです。この構造により、マルチモーダルなリクエストを送信できます。

リクエストを送信する
それでは、converseメソッドを使ってAPI呼び出しを行うことができます。
response = client.converse(
modelId=model_id,
messages=[user_message]
)レスポンスには多くのメタデータが含まれていますが、生成されたテキストだけを取得するには、レスポンスの構造をたどる必要があります。
response["output"]["message"]["content"][0]["text"]メッセージタイプの理解
扱うメッセージタイプには主に2種類あります。
- ユーザーメッセージ - モデルに与えたいコンテンツ(role: "user")
- アシスタントメッセージ - モデルが生成したコンテンツ(role: "assistant")

どちらのメッセージタイプも、roleとcontent listという同じ構造に従います。この一貫性により、ユーザーメッセージとアシスタントメッセージを交互に並べて会話を構築することが容易になります。
Bedrockから返ってくるアシスタントメッセージは、roleが異なるだけで、ユーザーメッセージとまったく同じフォーマットに従います。この標準化された構造により、より長い会話のために複数のリクエストを連結することが簡単になります。