API 레퍼런스지원 및 구성

버전

Copy page



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

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

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

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

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

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

버전 기록

Anthropic은 가능한 한 최신 API 버전을 사용할 것을 권장합니다.

• 2026-10-21
  • API 버전 2026-10-21로 마이그레이션에서 업그레이드 방법을 확인할 수 있습니다.
  • Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Microsoft Foundry, Claude Models on Google Cloud (Google managed)에서 사용할 수 있습니다. Amazon Bedrock에서는 Claude 4.7 이후 모델에서 사용할 수 있습니다. Bedrock의 다른 모델에 대해서는 API 버전 2026-10-21 마이그레이션 가이드를 참조하세요.
  • Messages API:
    • assistant 메시지에 document 블록을 직접 배치하는 요청은 400 오류를 반환합니다.
    • user 메시지에서 비어 있지 않은 citations 배열을 가진 text 블록을 직접 또는 search_result 블록 내부에 보내면 400 오류를 반환합니다.
    • temperature, top_p, top_k 요청 매개변수가 제거되었습니다. 이 중 하나라도 보내는 요청은 모든 모델에서 400 오류를 반환합니다.
  • Admin API:
    • RBAC 그룹API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요.은 더 이상 roles를 반환하지 않습니다. 대신 role_ids를 사용하세요.
    • RBAC 그룹 멤버API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 및 멤버 제거에 대한 응답은 더 이상 group_id를 반환하지 않습니다. 대신 rbac_group_id를 사용하세요.
    • RBAC 역할API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요.은 더 이상 name을 반환하지 않습니다. 대신 display_name을 사용하세요.
    • 조직API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 및 워크스페이스API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 속도 제한 항목, 그리고 워크스페이스의 속도 제한 설정API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요.에 대한 응답은 더 이상 group_type을 반환하지 않습니다. 대신 group.type을 사용하세요.
    • API 키API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요.는 더 이상 workspace_id를 반환하지 않습니다. 대신 scope.workspace_id를 사용하세요. 이 값은 기본 워크스페이스의 경우에도 워크스페이스의 실제 ID를 제공합니다(모든 워크스페이스용 키는 scope에 workspace_id가 없습니다).
  • Claude Enterprise Analytics API:
    • 사용자별 사용량API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 및 비용API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 보고서에는 더 이상 actor.email이 없습니다. 대신 actor.email_address를 사용하세요.
    • 활동 요약API 참조 링크가 포함된 미리보기 사용 가능 — 카드에 포커스가 들어올 때까지 Tab을 누르고, 돌아가려면 Escape를 누르세요. 응답에는 더 이상 summaries가 없습니다. 대신 data를 사용하세요.
• 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: 최초 릴리스.