翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
リクエストとレスポンス
リクエストボディは、InvokeModel または InvokeModelWithResponseStream へのリクエストの body フィールドに渡されます。リクエストで送信できるペイロードの最大サイズは 20MB です。
詳細については、https://docs.anthropic.com/claude/reference/messages_post
警告
Claude Sonnet 4.5 と は、 temperatureまたは パラメータのいずれかの仕様Claude Haiku 4.5のみをサポートしますがtop_p、両方を処理できません。これは、古いモデルには適用されません。
- Request
-
Anthropic Claude には、メッセージ推論呼び出しの次の推論パラメータがあります。
{ "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": ["computer-use-2024-10-22"] "max_tokens": int, "system": 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 モデルによって異なります。詳細については、「モデルの比較」を参照してください。 -
messages – (必須) 入力メッセージ。
-
role – 会話ターンのロール。有効な値は、
userおよびassistantです。最小値 最大値 0
2000
-
content – (必須) オブジェクトの配列としての会話ターンの内容。各オブジェクトにはタイプフィールドが含まれており、次のいずれかの値を指定できます。
-
text– このタイプを指定する場合は、テキストフィールドを含め、テキストプロンプトを値として指定する必要があります。配列内の別のオブジェクトがイメージである場合、このテキストプロンプトはイメージに適用されます。 -
image– このタイプを指定する場合は、次のフィールドを持つオブジェクトにマッピングするソースフィールドを含める必要があります。-
type – (必須) イメージのエンコードタイプ。
base64を指定できます。 -
media_type – (必須) イメージのタイプ。以下のイメージ形式を指定できます。
-
image/jpeg -
image/png -
image/webp -
image/gif
-
-
data – (必須) イメージの base64 でエンコードされたイメージバイト。最大サイズは 3.75 MB です。イメージの最大高さと幅は 8,000 ピクセルです。
-
-
-
オプションのパラメータを以下に示します。
-
system – (オプション) リクエストのシステムプロンプト。
システムプロンプトは、特定の目標やロールを指定するなど、Anthropic Claude にコンテキストや指示を指定する方法です。詳細については、「Anthropic ドキュメント」の「システムプロンプト
」を参照してください。 注記
システムプロンプトは、Anthropic Claude バージョン 2.1 以降で使用できます。
-
anthropic_beta – (オプション) anthropic beta パラメータは、特定のベータ機能のセットへのオプトインを示すために使用されるベータヘッダーの文字列のリストです。
注記
の 100 万個のトークンコンテキスト長バリアントClaude Sonnet 4は、 AWS サービス条件で定義されている「ベータサービス」として、一部の AWS リージョンで利用できます。本ライセンス条項には、 AWS および AWS サービス条件、および該当するモデル EULA とのお客様の契約が適用されます。長いコンテキストリクエストの料金の詳細については、Amazon Bedrock
の料金ページを参照してください。個別のサービスクォータが適用されます (詳細については、「」のService Quotas」を参照してください AWS Management Console)。 使用可能なベータヘッダーは次のとおりです。
ベータ版機能
ベータヘッダー
注意
コンピュータの使用
computer-use-2025-01-24と互換性がありますClaude 3.7 Sonnet。
ツールの使用
token-efficient-tools-2025-02-19Claude 3.7 Sonnet および 4+ Claude と互換性があります。
インターリーブ思考
Interleaved-thinking-2025-05-144 Claude つ以上のモデルと互換性があります。
最大 128K の出力トークンを有効にする
output-128k-2025-02-19と互換性がありますClaude 3.7 Sonnet。
4 Claude つ以上のモデルでの生の思考のためのデベロッパーモード
dev-full-thinking-2025-05-144 Claude つ以上のモデルとのみ互換性があります。このベータ版にアクセスするには、アカウントチームにお問い合わせください。
100 万トークン
context-1m-2025-08-07と互換性がある Claude Sonnet 4
コンテキスト管理
context-management-2025-06-27Claude Sonnet 4.5 および と互換性があります Claude Haiku 4.5
-
stop_sequences – (オプション) モデルの生成を停止させるカスタムテキストシーケンス。Anthropic Claudeモデルは通常、ターンが自然に完了すると停止します。この場合、
stop_reasonレスポンスフィールドの値はend_turnです。モデルがテキストのカスタム文字列に直面した際に、モデルの生成を停止する場合は、stop_sequencesパラメータを使用します。モデルがカスタムテキスト文字列のいずれかに直面した場合、stop_reasonレスポンスフィールドの値は、stop_sequenceになり、stop_sequenceの値には、一致したストップシーケンスが含まれます。最大入力数は、8191 です。
-
temperature – (オプション) レスポンスに注入されるランダム性の量です。
デフォルト値 最小値 最大値 1
0
1
-
top_p – (オプション) nucleus サンプリングを使用します。
nucleus サンプリングでは、Anthropic Claude は、後続の各トークンのすべてのオプションに対する累積分布を確率の降順で計算し、
top_pで指定された特定の確率に達すると切り捨てます。サンプリングパラメータを調整するときは、temperatureまたは を変更しますtop_p。両方を同時に変更しないでください。デフォルト 最小値 最大値 0.999
0
1
-
top_k – (オプション) 後続の各トークンの top K オプションのサンプルのみ。
top_kを使用して、ロングテールの低確率レスポンスを削除します。デフォルト値 最小値 最大値 デフォルトでは無効になっています。
0
500
-
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 – モデルが制御するディスプレイのピクセル単位の高さ。
デフォルト値 最小値 最大値 なし
1
最大解像度なし
-
(必須) display_width_px – モデルが制御するディスプレイのピクセル単位の幅。
デフォルト値 最小値 最大値 なし
1
最大解像度なし
-
(オプション) display_number – 制御する表示番号 (X11 環境にのみ関連)。指定した場合、ツールは、ツール定義で表示番号を指定します。
デフォルト値 最小値 最大値 なし
0
N
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入力フィールドで指定したストップシーケンスのいずれかを生成しました。 -
拒否 – Claude は、安全上の懸念によりレスポンスの生成を拒否します
-
tool_use – Claude はツールを呼び出しており、ツールの実行を期待しています
-
model_context_window_exceeded – コンテキストウィンドウの制限に達したため、モデルの生成が停止しました。
-
Claude Sonnet 4.5 の新機能
-
-
-
stop_sequence – 生成を終了したストップシーケンス。
-
type – レスポンスのタイプ。値は常に
messageです。 -
role – 生成されたメッセージの会話ロール。値は常に
assistantです。 -
content – モデルが生成したコンテンツ。配列として返されます。コンテンツには、テキスト、Tool_use、イメージの 3 種類があります。
-
text – テキストレスポンス。
-
type – コンテンツのタイプ。値は
textです。 -
text – の値が text
typeの場合、 にはコンテンツのテキストが含まれます。
-
-
ツールの使用 – ツールを使用するためのモデルからのリクエスト。
-
type – コンテンツのタイプ。値は
tool_useです。 -
id – モデルが使用をリクエストしているツールの ID。
-
name – リクエストされたツールの名前が含まれます。
-
input – ツールに渡す入力パラメータ。
-
-
イメージ – ツールを使用するためのモデルからのリクエスト。
-
type – コンテンツのタイプ。値は
imageです。 -
source – イメージが含まれます。詳細については、「マルチモーダルプロンプト」を参照してください。
-
-
-
usage – リクエストで指定したトークン数と、レスポンスで生成されたモデル数トークンのコンテナ。
-
input_tokens – リクエスト内の入力トークン数。
-
output_tokens – レスポンスでモデルが生成したトークン数。
-
stop_sequence – モデルが、
stop_sequences入力フィールドで指定したストップシーケンスのいずれかを生成しました。
-
-