텍스트 모델고급 사용자업데이트
POST/v1/messages

API 콘솔

POST/v1/messages
키 보기

입력한 키로 실제 요청을 보내며 일반 API 요금이 적용됩니다.

Claude Sonnet 5.5

요청 ID claude-sonnet-5-5

프로토콜

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

  • Anthropic Messages · x-api-key: YOUR_API_KEY

요청 매개변수

POST /v1/messages

필드유형필수 여부설명
modelstring필수모델 ID를 claude-sonnet-5-5로 설정하세요.
messagesobject[]필수user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다.
messages[].contentstring / object[]필수메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
messages[].content[]object조건부이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다.
systemstring / object[]선택시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
max_tokensinteger필수출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
streamboolean선택true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
thinking.typestring선택adaptive 또는 between_tools를 사용하세요. 후자는 도구 호출 사이에서만 추론합니다.
output_config.effortstring조건부요청할 추론 강도입니다. 사용 가능한 단계와 추론을 끌 수 있는지는 모델과 엔드포인트에 따라 다릅니다.
toolsobject[]조건부모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
tool_choiceobject조건부일반 도구에는 type: auto를 사용하세요. 이 모델에서는 any나 tool로 일반 도구 호출을 강제할 수 없습니다.

POST /v1/messages/count_tokens

필드유형필수 여부설명
modelstring필수모델 ID를 claude-sonnet-5-5로 설정하세요.
messagesobject[]필수user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다.
messages[].contentstring / object[]필수메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
messages[].content[]object조건부이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다.
systemstring / object[]선택시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
toolsobject[]조건부입력 토큰 계산에 포함할 도구 정의입니다. 실제 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 (은퇴 리디렉션)

모델 기능 카탈로그 · 가격 보기