Anthropic Vertex SDK, 모델 경로 인코딩 보완

모델 이름이 요청 경로를 바꾸지 않도록 합니다

한국시간 2026년 11월 5일 공개된 Anthropic Vertex SDK 1.1.2는 프로젝트 ID·리전·모델을 요청 URL에 넣을 때 각각 인코딩하도록 보완했습니다. 모델 값에 슬래시가 포함돼도 SDK가 정한 /publishers/anthropic/models/ 바깥의 경로로 요청이 바뀌지 않도록 하는 수정입니다. 새로운 모델을 추가하거나 추론 속도를 높이는 업데이트는 아닙니다.

URL에서 슬래시는 경로를 나누는 구분자입니다. 하나의 모델 식별자로 전달한 문자열에 들어 있는 슬래시까지 구분자로 처리하면, 호출자가 의도한 값과 실제 요청 위치가 달라질 수 있습니다. 각 입력을 경로 조각으로 인코딩하면 SDK가 만든 경계와 입력 안의 문자를 구별할 수 있습니다.

거부되는 값의 대상을 정확히 읽습니다

공식 릴리스가 명시한 오류 조건은 빈 model, 그리고 . 또는 ..인 프로젝트 ID나 리전입니다. 이 경우 AnthropicError를 발생시킨다고 설명합니다. 점 한 개나 두 개로 된 모델 이름을 별도로 거부한다고 바꿔 설명하면 원문의 대상이 달라집니다. 기존 글의 모호한 설명을 이 구분에 맞춰 바로잡았습니다.

버전이 고정된 클라이언트 구현에서도 프로젝트·리전·모델이 함께 경로 템플릿에 들어가는 것을 확인할 수 있습니다. 일반 메시지는 rawPredict, 스트리밍 메시지는 streamRawPredict 호출 경로를 사용합니다. 요청 본문의 모델 값을 경로에 반영하는 과정이므로, 본문만 기록해서는 실제 호출 대상이 어떻게 구성됐는지 충분히 확인하기 어렵습니다.

프록시를 쓰는 환경에서 확인할 부분

구현은 기본 API 경로 끝부분을 교체하면서 앞쪽 경로 접두사를 유지하도록 작성돼 있습니다. 사용자 지정 기본 주소나 중간 계층을 쓰는 앱이라면, 익숙한 모델로 만든 요청의 목적지와 스트리밍 여부가 기존과 같은지 먼저 비교하는 것이 좋습니다. 중간 계층이 경로를 별도로 변경하는 상황도 있어 클라이언트 설정만으로 최종 동작을 단정할 수 없습니다.

인코딩에 성공하는 것과 Vertex 서비스가 그 모델을 허용하는 것은 별개입니다. 올바른 경로가 만들어져도 모델 제공 지역이나 계정의 사용 권한 조건 때문에 요청이 실패할 수 있습니다. 이런 오류를 이번 경로 수정이 자동으로 해결한다고 안내할 근거는 없습니다.

실제 호출 전에도 경로를 점검할 수 있습니다

테스트용 전송 함수를 사용하면 실제 추론 요청을 보내지 않고 완성된 URL을 확인할 수 있습니다. 일반 식별자와 특수 문자가 포함된 입력, 빈 모델을 나눠 경로 생성과 오류 처리를 비교하는 방법입니다. 앱에서 먼저 인코딩하던 코드가 있다면 이중 변환 여부도 확인할 만합니다. 이 글은 공개 릴리스와 구현을 대조했으며, 사용자의 클라우드 계정으로 요청하거나 프록시 환경에서 재현 시험을 수행한 결과는 아닙니다.

출처

• 공식 릴리스 원문
• 1.1.2 Vertex 클라이언트의 경로 구성