API 레퍼런스지원 및 구성

버전

Copy page



API 요청을 보낼 때는 anthropic-version 요청 헤더를 반드시 전송해야 합니다. 예를 들어 anthropic-version: 2023-06-01과 같습니다. 클라이언트 SDK를 사용하는 경우 이는 자동으로 처리됩니다.

Messages API의 특정 버전에 대해 Anthropic은 다음을 유지합니다:

• 기존 입력 매개변수
• 기존 출력 매개변수

그러나 Anthropic은 다음을 수행할 수 있습니다:

• 추가적인 선택적 입력 추가
• 출력에 추가적인 값 추가
• 특정 오류 유형에 대한 조건 변경
• 열거형(enum)과 유사한 출력 값에 새로운 변형 추가(예: 스트리밍 이벤트 유형)

일반적으로 이 레퍼런스에 문서화된 대로 API를 사용하고 있다면, Anthropic은 여러분의 사용 방식을 깨뜨리지 않습니다.

버전 기록

Anthropic은 가능한 한 최신 API 버전을 사용할 것을 권장합니다. 이전 버전은 지원 중단된 것으로 간주되며 신규 사용자는 사용할 수 없을 수 있습니다.

• 2023-06-01
  • 스트리밍 "server-sent events"(서버 전송 이벤트), 즉 SSE의 새로운 형식:
    • 완성(completion)이 증분 방식으로 제공됩니다. 예를 들어 " Hello", " Hello my", " Hello my name", " Hello my name is", " Hello my name is Claude." 대신 " Hello", " my", " name", " is", " Claude." 와 같이 제공됩니다.
    • 모든 이벤트는 데이터 전용 이벤트가 아닌 명명된 이벤트입니다.
    • 불필요한 data: [DONE] 이벤트를 제거했습니다.
  • 응답에서 레거시 exception 및 truncated 값을 제거했습니다.
• 2023-01-01: 최초 릴리스.