기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 요청 및 응답
요청 본문이 [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 및 Claude Haiku 4.5는 `temperature` 또는 `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\$1version** – (필수) Anthropic 버전입니다. 값은 `bedrock-2023-05-31`이어야 합니다.
+ **max\$1tokens** – (필수) 중지하기 전에 생성할 최대 토큰 수입니다.
참고로 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/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **content** - (필수) 객체의 배열로의 대화 턴의 콘텐츠입니다. 각 객체에는 다음 값 중 하나를 지정할 수 있는 **유형** 필드가 포함되어 있습니다.
+ `text` - 이 유형을 지정하는 경우 **텍스트** 필드를 포함하고 텍스트 프롬프트를 값으로 지정해야 합니다. 배열의 다른 객체가 이미지인 경우 이 텍스트 프롬프트가 이미지에 적용됩니다.
+ `image` - 이 유형을 지정하는 경우 다음 필드와 함께 객체에 매핑되는 **소스** 필드를 포함해야 합니다.
+ **type** – (필수) 이미지의 인코딩 유형입니다. `base64`를 지정할 수 있습니다.
+ **media\$1type** – (필수) 이미지의 유형입니다. 다음 이미지 형식을 지정할 수 있습니다.
+ `image/jpeg`
+ `image/png`
+ `image/webp`
+ `image/gif`
+ **data** - (필수) 이미지의 base64 인코딩 이미지 바이트입니다. 최대 이미지 크기는 3.75MB입니다. 이미지의 최대 높이와 너비는 8,000픽셀입니다.
다음 파라미터는 선택 사항입니다.
+ **system** – (선택 사항) 요청에 대한 시스템 프롬프트입니다.
시스템 프롬프트는 특정 목표 또는 역할을 지정하는 것과 같이 Anthropic Claude에 컨텍스트와 지침을 제공하는 방법입니다. 자세한 내용은 Anthropic 설명서의 [시스템 프롬프트](https://docs.anthropic.com/en/docs/system-prompts)를 참조하세요.
**참고**
Anthropic Claude 버전 2.1 이상의 시스템 프롬프트를 사용할 수 있습니다.
+ **anthropic\$1beta** – (선택 사항) anthropic 베타 파라미터는 특정 베타 기능 세트에 대한 옵트인을 나타내는 데 사용되는 베타 헤더 문자열 목록입니다.
**참고**
일부 AWS 리전에서는 AWS 서비스 약관에 정의된 대로 1백만 Claude Sonnet 4 개의 토큰 컨텍스트 길이 변형을 "베타 서비스"로 사용할 수 있습니다. 여기에는 계약 AWS 및 AWS 서비스 약관과 해당 모델 EULA가 적용됩니다. 더 긴 컨텍스트 요청 요금에 대한 자세한 내용은 [Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/) 요금 페이지를 참조하세요. 별도의 서비스 할당량이 적용됩니다(자세한 내용은의 **Service Quotas** 참조 AWS Management Console).
사용 가능한 베타 헤더는 다음과 같습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **stop\$1sequences** – (선택 사항) 모델의 생성을 중지하는 사용자 지정 텍스트 시퀀스입니다. Anthropic Claude 모델은 일반적으로 턴을 자연적으로 완료하면 중지되며, 이 경우 `stop_reason` 응답 필드의 값은 `end_turn`입니다. 사용자 지정 텍스트 문자열이 표시될 때 모델 생성을 중지하려면 `stop_sequences` 파라미터를 사용할 수 있습니다. 모델이 사용자 지정 텍스트 문자열 중 하나를 발견하면 `stop_reason` 응답 필드의 값은 `stop_sequence`이고 `stop_sequence`의 값에는 일치하는 중지 시퀀스가 포함됩니다.
항목의 최대 수는 8,191입니다.
+ **temperature** – (선택 사항) 응답에 주입되는 무작위성의 양입니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\$1p** – (선택 사항) Nucleus 샘플링을 사용합니다.
Nucleus 샘플링에서 Anthropic Claude는 각 후속 토큰의 모든 옵션에 대한 누적 분포를 확률 내림차순으로 계산하고 `top_p`에서 지정한 특정 확률에 도달하면 이를 차단합니다. 샘플링 파라미터를 조정할 때 `temperature` 또는 `top_p` 중 하나를 수정합니다. 두 가지를 동시에 수정하지 마세요.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\$1k** – (선택 사항) 각 후속 토큰에 대해 상위 K개 옵션에서만 샘플을 추출합니다.
`top_k`를 사용하여 롱 테일 낮은 확률 응답을 제거합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/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\$1schema** – 도구의 JSON 스키마입니다.
**컴퓨터**
Computer Use API와 함께 사용하는 컴퓨터 도구에 대한 정의입니다.
+ **type** – 값은 `computer_20241022`여야 합니다.
+ **name** - 값은 `computer`여야 합니다.
+ (필수) **display\$1height\$1px** - 모델이 제어하는 디스플레이의 높이를 픽셀 단위로 표시합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (필수) **display\$1width\$1px** - 모델이 제어하는 디스플레이의 너비를 픽셀 단위로 표시합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (선택 사항) **display\$1number** – 제어할 디스플레이 번호입니다(X11 환경만 해당). 지정된 경우 도구 정의에 디스플레이 번호가 제공됩니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
**bash**
Computer Use API와 함께 사용하는 Bash 도구에 대한 정의입니다.
+ (선택 사항) **type** - 값은 `bash_20241022`여야 합니다.
+ **name** - 값은 `bash` 도구여야 합니다.
**text editor**
Computer Use API와 함께 사용하는 텍스트 편집기 도구에 대한 정의입니다.
+ (선택 사항) **type** - 값은 `text_editor_20241022`여야 합니다.
+ **name** - 값은 `str_replace_editor` 도구여야 합니다.
+ **tool\$1choice** – (선택 사항) 모델이 제공된 도구를 사용하는 방법을 지정합니다. 모델은 특정 도구 또는 사용 가능한 도구를 사용하거나 자체적으로 결정할 수 있습니다.
**참고**
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\$1reason 값이 있는 응답의 예:
```
// 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\$1reason** – Anthropic Claude가 응답 생성을 중지한 이유입니다.
+ **end\$1turn** - 모델이 자연 중단점에 도달했습니다.
+ **max\$1tokens** - 생성된 텍스트가 `max_tokens` 입력 필드 값을 초과하거나 모델이 지원하는 최대 토큰 수를 초과했습니다.
+ **stop\$1sequence** – 모델이 `stop_sequences` 입력 필드에 지정한 중지 시퀀스 중 하나를 생성했습니다.
+ **거부** - Claude가 안전 문제로 인한 응답 생성을 거부합니다
+ **tool\$1use** - Claude가 도구를 직접적으로 호출하고 이를 실행할 것으로 예상합니다
+ **model\$1context\$1window\$1exceeded** - 컨텍스트 창 제한에 도달하여 모델 생성이 중지되었습니다.
+ Claude Sonnet 4.5의 새로운 기능
+ **stop\$1sequence** – 생성을 종료한 중지 시퀀스입니다.
+ **type** - 응답 유형입니다. 이 값은 항상 `message`입니다.
+ **role** - 생성된 메시지의 대화 역할입니다. 이 값은 항상 `assistant`입니다.
+ **content** - 모델에서 생성된 콘텐츠입니다. 배열로 반환됩니다. 콘텐츠에는 *텍스트*, *tool\$1use* 및 *이미지*의 세 가지 유형이 있습니다.
+ *text* - 텍스트 응답입니다.
+ **type** – 콘텐츠 유형입니다. 이 값은 `text`입니다.
+ **text** - `type`의 값이 텍스트인 경우 콘텐츠의 텍스트를 포함합니다.
+ *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\$1tokens** - 요청의 입력 토큰 수입니다.
+ **output\$1tokens** - 모델에서 응답으로 생성한 토큰 수입니다.
+ **stop\$1sequence** – 모델이 `stop_sequences` 입력 필드에 지정한 중지 시퀀스 중 하나를 생성했습니다.
------
## Effort 파라미터(베타)
`effort` 파라미터는 Claude Opus 4.5에 대한 토큰 예산을 고려하는 대신 사용할 수 있습니다. 이 파라미터는 사고, 도구 호출 및 사용자 통신 전반에서 토큰 사용량을 조정하여 최상의 결과를 얻기 위해 토큰을 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"
}]
}
```