翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# リクエストとレスポンス
リクエストボディは、[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) または [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) へのリクエストの `body` フィールドに渡されます。
**注記**
制限は、`InvokeModel`、、`InvokeModelWithResponseStream``Converse`、および のオペレーションに適用されます`ConverseStream`。詳細については、[「API の制限](inference-api-restrictions.md)」を参照してください。
**警告**
Claude Sonnet 4.5 と は、 パラメータ`temperature`または `top_p`パラメータのいずれかの指定Claude Haiku 4.5をサポートしますが、両方はサポートしません。これは、古いモデルには適用されません。
------
#### [ Request ]
Anthropic Claude には、メッセージ推論呼び出しの次の推論パラメータがあります。
```
{
"anthropic_version": "bedrock-2023-05-31",
"anthropic_beta": ["computer-use-2024-10-22"]
"max_tokens": int,
"system": string | [{"type": "text", "text": string}],
"messages": [
{
"role": string,
"content": [
{ "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "{{content image bytes}}" } },
{ "type": "text", "text": "{{content text}}" }
]
}
],
"temperature": float,
"top_p": float,
"top_k": int,
"tools": [
{
"type": "custom",
"name": string,
"description": string,
"input_schema": json
},
{
"type": "computer_20241022",
"name": "computer",
"display_height_px": int,
"display_width_px": int,
"display_number": 0 int
},
{
"type": "bash_20241022",
"name": "bash"
},
{
"type": "text_editor_20241022",
"name": "str_replace_editor"
}
],
"tool_choice": {
"type" : string,
"name" : string,
},
"stop_sequences": [string]
}
```
必須パラメータを以下に示します。
+ **anthropic\_version** – (必須) anthropic バージョン。値は `bedrock-2023-05-31` にする必要があります。
+ **max\_tokens** – (必須) 停止する前に生成するトークンの最大数。
Anthropic Claude モデルは、`max_tokens` の値に達する前にトークンの生成を停止する場合があるのでご注意ください。このパラメータの最大値は Anthropic Claude モデルによって異なります。詳細については、「[モデルの比較](https://docs.anthropic.com/claude/docs/models-overview#model-comparison)」を参照してください。
+ **messages** – (必須) 入力メッセージ。
+ **role** – 会話ターンのロール。有効な値は、`user` および `assistant` です。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **content** – (必須) 会話ターンの内容 (オブジェクトの配列)。各オブジェクトには **type** フィールドが含まれており、次のいずれかの値を指定できます。
+ `text` – このタイプを指定する場合は、**text** フィールドを含め、テキストプロンプトを値として指定する必要があります。配列内の別のオブジェクトが画像の場合、このテキストプロンプトはイメージに適用されます。
+ `image` – このタイプを指定する場合は、次のフィールドを持つオブジェクトにマッピングする **source** フィールドを含める必要があります。
+ **type** – (必須) イメージのエンコードタイプ。`base64` を指定できます。
+ **media\_type** – (必須) イメージのタイプ。以下のイメージ形式を指定できます。
+ `image/jpeg`
+ `image/png`
+ `image/webp`
+ `image/gif`
+ **data** – (必須) イメージの base64 でエンコードされたイメージバイト。最大サイズは 3.75 MB です。イメージの最大高さと幅は 8,000 ピクセルです。
オプションのパラメータを以下に示します。
+ **system** – (オプション) リクエストのシステムプロンプト。システムプロンプトは、文字列またはコンテンツブロックの配列 ( など) として指定できます`[{"type": "text", "text": "your prompt"}]`。
システムプロンプトは、特定の目標やロールを指定するなど、Anthropic Claude にコンテキストや指示を指定する方法です。詳細については、「Anthropic ドキュメント」の「[システムプロンプト](https://docs.anthropic.com/en/docs/system-prompts)」を参照してください。
**注記**
システムプロンプトは、Anthropic Claude バージョン 2.1 以降で使用できます。
+ **anthropic\_beta** – (オプション) anthropic beta パラメータは、特定のベータ機能のセットへのオプトインを示すために使用されるベータヘッダーの文字列のリストです。
**注記**
の 100 万個のトークンコンテキスト長バリアントClaude Sonnet 4は、 AWS サービス条件で定義されている「ベータサービス」として、一部の AWS リージョンで利用できます。本ライセンス条項には、 AWS および AWS サービス条件、および該当するモデル EULA とのお客様の契約が適用されます。長いコンテキストリクエストの料金の詳細については、「[Amazon Bedrock の料金](https://aws.amazon.com/bedrock/pricing/)」ページを参照してください。200K個の入力トークンを超えるリクエストの場合、ロングコンテキストレートはしきい値を超えるトークンだけでなく、リクエスト全体に適用されます。個別のサービスクォータが適用されます (詳細については、「」の**Service Quotas**」を参照してください AWS マネジメントコンソール)。
使用可能なベータヘッダーは次のとおりです。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **stop\_sequences** – (オプション) モデルの生成を停止させるカスタムテキストシーケンス。Anthropic Claudeモデルは通常、ターンが自然に完了すると停止します。この場合、`stop_reason` レスポンスフィールドの値は `end_turn` です。モデルがテキストのカスタム文字列に直面した際に、モデルの生成を停止する場合は、`stop_sequences` パラメータを使用します。モデルがカスタムテキスト文字列のいずれかに直面した場合、`stop_reason` レスポンスフィールドの値は、`stop_sequence` になり、`stop_sequence` の値には、一致したストップシーケンスが含まれます。
最大入力数は、8191 です。
+ **temperature** – (オプション) レスポンスに注入されるランダム性の量です。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\_p** – (オプション) nucleus サンプリングを使用します。
nucleus サンプリングでは、Anthropic Claude は、後続の各トークンのすべてのオプションに対する累積分布を確率の降順で計算し、`top_p` で指定された特定の確率に達すると切り捨てます。サンプリングパラメータを調整するときは、`temperature`または `top_p` を変更します。両方を同時に変更しないでください。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\_k** – (オプション) 後続の各トークンの top K オプションのサンプルのみ。
`top_k` を使用して、ロングテールの低確率レスポンスを削除します。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **tools** – (オプション) モデルが使用する可能性があるツールの定義です。
**注記**
Anthropic Claude 3 モデルが必要です。
`tools` をリクエストに含める場合、モデルは、`tool_use` コンテンツブロックを返す場合があります。これは、モデルがそれらのツールを使用することを表しています。その後、モデルが生成したツール入力を使用してこれらのツールを実行し、必要に応じて、`tool_result` コンテンツブロックを使用してモデルに結果を返します。
次のツールタイプを渡すことができます。
**カスタム**
カスタムツールの定義。
+ (オプション) **type** – ツールのタイプ。定義されている場合は、値 `custom` を使用します。
+ **name** – ツール名。
+ **description** – (オプションですが、強く推奨) ツールの説明。
+ **input\_schema** – ツールの JSON スキーマ。
**[コンピュータ]**
Computer Use API で使用するコンピューターツールの定義。
+ **type** – 値は `computer_20241022` である必要があります。
+ **name** – 値は `computer` である必要があります。
+ (必須) **display\_height\_px** – モデルが制御するディスプレイのピクセル単位の高さ。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (必須) **display\_width\_px** – モデルが制御するディスプレイのピクセル単位の幅。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (オプション) **display\_number** – 制御する表示番号 (X11 環境にのみ関連)。指定した場合、ツールは、ツール定義で表示番号を指定します。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
**bash**
Computer Use API で使用するバッシュツールの定義。
+ (オプション) **type** – 値は `bash_20241022` である必要があります。
+ **name** – 値は `bash` である必要があります。
**テキストエディタ**
Computer Use API で使用するテキストエディタツールの定義。
+ (オプション) **type** – 値は `text_editor_20241022` である必要があります。
+ **name** – 値は `str_replace_editor` である必要があります。
+ **tool\_choice** – (オプション) モデルが提供されたツールを使用する方法を指定します。モデルは、特定のツール、使用可能な任意のツールを使用するかを単独で決定できます。
**注記**
Anthropic Claude 3 モデルが必要です。
+ **type** – ツール選択のタイプ。可能な値は、`any` (使用可能な任意のツールを使用)、`auto` (モデルが決定)、`tool` (指定されたツールを使用) です。
+ **name** – (オプション) 使用するツール名。`type` フィールドで `tool` を指定する場合に必要です。
------
#### [ Response ]
Anthropic Claude モデルは、メッセージ推論呼び出しに次のフィールドを返します。
```
{
"id": string,
"model": string,
"type" : "message",
"role" : "assistant",
"content": [
{
"type": string,
"text": string,
"image" :json,
"id": string,
"name":string,
"input": json
}
],
"stop_reason": string,
"stop_sequence": string,
"usage": {
"input_tokens": integer,
"output_tokens": integer
}
}
```
新しい stop\_reason 値を使用したレスポンスの例:
```
// Example with refusal
{
"stop_reason": "refusal",
"content": [
{
"type": "text",
"text": "I can't help with that request."
}
]
}
// Example with tool_use
{
"stop_reason": "tool_use",
"content": [
{
"type": "tool_use",
"id": "toolu_123",
"name": "calculator",
"input": {"expression": "2+2"}
}
]
}
// Example with model_context_window_exceeded (Claude Sonnet 4.5)
{
"stop_reason": "model_context_window_exceeded",
"content": [
{
"type": "text",
"text": "The response was truncated due to context window limits..."
}
]
}
```
+ **id** – レスポンスの一意の識別子。ID の形式と長さは、時間の経過とともに変わる場合があります。
+ **model** – リクエストを行った Anthropic Claude モデルの ID。
+ **stop\_reason** – Anthropic Claude がレスポンスの生成を停止した理由。
+ **end\_turn** – モデルが自然な停止点に達しました。
+ **max\_tokens** – 生成されたテキストが `max_tokens` 入力フィールドの値を超えたか、モデルがサポートするトークンの最大数を超えました。
+ **stop\_sequence** – モデルが、`stop_sequences` 入力フィールドで指定したストップシーケンスのいずれかを生成しました。
+ **refusal** – Claude は、安全上の懸念によりレスポンスの生成を拒否します。
+ **tool\_use** – Claude はツールを呼び出し、それを実行することを期待しています。
+ **model\_context\_window\_exceeded** – コンテキストウィンドウの制限に達したため、モデルの生成が停止しました。
+ Claude Sonnet 4.5 の新機能
+ **stop\_sequence** – 生成を終了したストップシーケンス。
+ **type** – レスポンスのタイプ。値は常に `message` です。
+ **role** – 生成されたメッセージの会話ロール。値は常に `assistant` です。
+ **content** – モデルが生成したコンテンツ。配列として返されます。コンテンツには、*text*、*tool\_use*、*image*の 3 種類があります。
+ *text* – テキストレスポンス。
+ **type** – コンテンツのタイプ。値は `text` です。
+ **text** – `type` の値が text の場合、コンテンツのテキストが含まれます。
+ *tool use* – ツールを使用するためのモデルからのリクエスト。
+ **type** – コンテンツのタイプ。値は `tool_use` です。
+ **id** – モデルが使用をリクエストしているツールの ID。
+ **name** – リクエストされたツールの名前が含まれます。
+ **input** – ツールに渡す入力パラメータ。
+ *Image* – ツールを使用するためのモデルからのリクエスト。
+ **type** – コンテンツのタイプ。値は `image` です。
+ **source** – 画像が含まれます。詳細については、「[マルチモーダルプロンプト](model-parameters-anthropic-claude-messages.md#model-parameters-anthropic-claude-messages-multimodal-prompts)」を参照してください。
+ **usage** – リクエストで指定したトークン数と、レスポンスで生成されたモデル数トークンのコンテナ。
+ **input\_tokens** – リクエスト内の入力トークン数。
+ **output\_tokens** – レスポンスでモデルが生成したトークン数。
+ **stop\_sequence** – モデルが、`stop_sequences` 入力フィールドで指定したストップシーケンスのいずれかを生成しました。
------
## Effort パラメータ (ベータ)
`effort` パラメータは、4.5 Claude Opus のトークン予算を考える代わりに使用できます。このパラメータは、トークンをどの程度自由に使用して最良の結果を得るClaudeかを示し、思考、ツール呼び出し、ユーザー通信全体でトークンの使用状況を調整します。拡張思考モードの有無にかかわらず使用できます。
エフォートパラメータは次のように設定できます。
+ `high` (デフォルト) – 最適な結果を得るために必要な数のトークンをClaude消費します
+ `medium` – バランスの取れたトークンの使用
+ `low` – 保守的なトークンの使用
この機能を使用するには、ベータヘッダー を渡す必要があります`effort-2025-11-24`。
リクエストの例:
```
{
"anthropic_version": "bedrock-2023-05-31",
"anthropic_beta": [
"effort-2025-11-24"
],
"max_tokens": 4096,
"output_config": {
"effort": "medium"
},
"messages": [{
"role": "user",
"content": "Analyze this complex dataset and provide insights"
}]
}
```