Claude Sonnet 5.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-5-5` 로 고정

messagesarray[object]필수

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

max_tokensinteger필수

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

systemstring | array[object]선택

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

streamboolean선택

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

stop_sequencesarray[string]선택

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

toolsarray[object]선택

도구 사용을 위한 도구 정의

tool_choiceobject선택

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

metadataobject선택

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

thinkingobject선택

이 필드를 생략하면 적응형 사고가 기본으로 활성화되며 `disabled`로 끌 수 있음

output_configobject선택

출력 설정; 사용 가능한 하위 필드는 모델에 따라 다름

예시

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

{  "model": "claude-sonnet-5-5",  "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-5-5",
    "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-5-5",    "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 5.5 · Messages

요청 파라미터

요청 코드 예시

응답

On this page