텍스트 모델고급 사용자업데이트
POST/v1/messages
Claude Sonnet 5.5
요청 ID claude-sonnet-5-5
프로토콜
POST /v1/messages· Anthropic Messages 예시POST /v1/messages/count_tokens· Count Tokens 예시
인증
요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.
- Anthropic Messages ·
x-api-key: YOUR_API_KEY
요청 매개변수
POST /v1/messages
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 claude-sonnet-5-5로 설정하세요. |
messages | object[] | 필수 | user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다. |
messages[].content | string / object[] | 필수 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
messages[].content[] | object | 조건부 | 이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다. |
system | string / object[] | 선택 | 시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다. |
max_tokens | integer | 필수 | 출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
thinking.type | string | 선택 | adaptive 또는 between_tools를 사용하세요. 후자는 도구 호출 사이에서만 추론합니다. |
output_config.effort | string | 조건부 | 요청할 추론 강도입니다. 사용 가능한 단계와 추론을 끌 수 있는지는 모델과 엔드포인트에 따라 다릅니다. |
tools | object[] | 조건부 | 모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다. |
tool_choice | object | 조건부 | 일반 도구에는 type: auto를 사용하세요. 이 모델에서는 any나 tool로 일반 도구 호출을 강제할 수 없습니다. |
POST /v1/messages/count_tokens
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 claude-sonnet-5-5로 설정하세요. |
messages | object[] | 필수 | user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다. |
messages[].content | string / object[] | 필수 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
messages[].content[] | object | 조건부 | 이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다. |
system | string / object[] | 선택 | 시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다. |
tools | object[] | 조건부 | 입력 토큰 계산에 포함할 도구 정의입니다. 실제 Messages 요청과 같은 도구를 전달하세요. |
요청 예시
API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Count Tokens
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-sonnet-5-5",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
응답 읽기
- Anthropic Messages ·
content[]에서 유형이text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE - Count Tokens ·
input_tokens에서 입력 토큰 수를 읽으세요.
기능 및 제한
streaming· 지원tool_calling· 지원image_input· 조건부 지원 — 호환 엔드포인트와 요청 형식에 따라 달라집니다video_input· 미지원
호환 별칭 및 은퇴 리디렉션
claude-sonnet-4-5,claude-sonnet-4-5-20250514,claude-sonnet-4-5-20250929,claude-sonnet-4-6→claude-sonnet-5-5(은퇴 리디렉션)
관련 가이드
Claude Code 설치, API 설정 및 Windows 오류 해결
Claude Code 설치, API 키와 접속 주소 설정, Windows·macOS·Linux 환경 확인부터 인증 오류와 연결 문제 해결까지 안내하고 Desktop·Kimi·GLM 설정을 연결합니다.
Anthropic Messages
Anthropic Messages 형식으로 HTTP 요청을 보냅니다. Claude Code 설정은 관련 가이드를 참고하세요.
모델 기능 카탈로그
공개 텍스트, 이미지 및 동영상 모델의 정규화된 요청 ID, 호환 프로토콜, 지원 클라이언트, 도구 호출, 미디어 입력·출력 기능, 제한 사항과 검토 날짜를 비교합니다.