Claude Sonnet 4.5 · Messages

POST/v1/messages

요청 파라미터

Authorization

Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.

Authorization: Bearer ****************

anthropic-version: 2023-06-01

Header 파라미터

Content-Typestring선택

application/json

Acceptstring선택

application/json

Body 파라미터application/json필수

modelstring필수

모델 ID, `claude-sonnet-4-5-20250929` 로 고정

messagesarray[object]필수

대화 메시지 목록; 각 항목은 `role`(user / assistant)와 `content`(텍스트 또는 콘텐츠 블록)를 가짐

max_tokensinteger필수

생성할 최대 토큰 수; Anthropic API 필수

systemstring | array[object]선택

시스템 프롬프트, 메시지가 아니라 최상위 필드로 전달

temperaturenumber선택

샘플링 온도; 높을수록 무작위성이 큼

top_pnumber선택

뉴클리어스 샘플링; `temperature`의 대안. 범위 `0`–`1`

top_kinteger선택

Top-k 샘플링; 확률이 가장 높은 K개 토큰으로 후보를 제한

streamboolean선택

응답을 스트리밍(SSE)할지 여부, 기본값 `false`

stop_sequencesarray[string]선택

사용자 지정 정지 시퀀스; 도달 시 생성 중단

toolsarray[object]선택

도구 사용을 위한 도구 정의

tool_choiceobject선택

도구 사용 여부와 대상을 제어

metadataobject선택

`user_id`와 같은 요청 메타데이터

thinkingobject선택

사고 설정; 지원 모드는 Claude 모델에 따라 다름

예시

{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "안녕하세요, 자기소개를 해주세요"
    }
  ]
}

{  "model": "claude-sonnet-4-5-20250929",  "max_tokens": 1024,  "messages": [    {      "role": "user",      "content": "안녕하세요, 자기소개를 해주세요"    }  ]}

요청 코드 예시

curl https://api.hotrouter.ai/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "안녕하세요, 자기소개를 해주세요"
      }
    ]
  }'

curl https://api.hotrouter.ai/v1/messages \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -H "anthropic-version: 2023-06-01" \  -d '{    "model": "claude-sonnet-4-5-20250929",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "안녕하세요, 자기소개를 해주세요"      }    ]  }'

응답

200 · 성공

idstring필수

이 응답의 고유 id

typestring필수

객체 유형(message)

rolestring필수

메시지 역할

contentarray[object]필수

콘텐츠 블록 배열

stop_reasonstring선택

종료 사유(end_turn / max_tokens 등)

usageobject필수

이번 호출의 토큰 사용량

예시

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "안녕하세요! 반갑습니다……"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 24
  }
}

{  "id": "msg_xxx",  "type": "message",  "role": "assistant",  "content": [    {      "type": "text",      "text": "안녕하세요! 반갑습니다……"    }  ],  "stop_reason": "end_turn",  "usage": {    "input_tokens": 12,    "output_tokens": 24  }}

Claude Sonnet 4.5 · Messages

요청 파라미터

요청 코드 예시

응답

On this page