Vertex AI API
Anthropic의 Claude 모델이 이제 Vertex AI를 통해 일반적으로 사용 가능합니다.
Claude에 액세스하기 위한 Vertex API는 Messages API와 거의 동일하며 동일한 모든 옵션을 지원하지만, 두 가지 주요 차이점이 있습니다:
- Vertex에서는
model
이 요청 본문에 전달되지 않습니다. 대신 Google Cloud 엔드포인트 URL에 지정됩니다. - Vertex에서는
anthropic_version
이 (헤더가 아닌) 요청 본문에 전달되며,vertex-2023-10-16
값으로 설정되어야 합니다.
Vertex는 또한 Anthropic의 공식 클라이언트 SDK에서도 지원됩니다. 이 가이드는 Python 또는 TypeScript에서 Vertex AI의 Claude에 요청을 만드는 과정을 안내합니다.
이 가이드는 이미 Vertex AI를 사용할 수 있는 GCP 프로젝트가 있다고 가정합니다. 필요한 설정과 전체 연습에 대한 자세한 정보는 Anthropic의 Claude 3 모델 사용을 참조하세요.
Vertex AI 액세스를 위한 SDK 설치
먼저, 선택한 언어에 대한 Anthropic의 클라이언트 SDK를 설치하세요.
Vertex AI 액세스
모델 가용성
Anthropic 모델 가용성은 지역에 따라 다릅니다. Vertex AI Model Garden에서 “Claude”를 검색하거나 최신 정보는 Claude 3 사용으로 이동하세요.
API 모델 이름
모델 | Vertex AI API 모델 이름 |
---|---|
Claude Opus 4 | claude-opus-4@20250514 |
Claude Sonnet 4 | claude-sonnet-4@20250514 |
Claude Sonnet 3.7 | claude-3-7-sonnet@20250219 |
Claude Haiku 3.5 | claude-3-5-haiku@20241022 |
Claude Sonnet 3.5 | claude-3-5-sonnet-v2@20241022 |
Claude Opus 3 (Public Preview) | claude-3-opus@20240229 |
Claude Sonnet 3 | claude-3-sonnet@20240229 |
Claude Haiku 3 | claude-3-haiku@20240307 |
요청 만들기
요청을 실행하기 전에 GCP로 인증하기 위해 gcloud auth application-default login
을 실행해야 할 수 있습니다.
다음 예제는 Vertex AI에서 Claude로부터 텍스트를 생성하는 방법을 보여줍니다:
자세한 내용은 클라이언트 SDK와 공식 Vertex AI 문서를 참조하세요.
활동 로깅
Vertex는 고객이 사용과 관련된 프롬프트와 완성을 로그할 수 있는 요청-응답 로깅 서비스를 제공합니다.
Anthropic은 활동을 이해하고 잠재적인 오용을 조사하기 위해 최소 30일 롤링 기준으로 활동을 로그할 것을 권장합니다.
이 서비스를 켜는 것은 Google이나 Anthropic에게 귀하의 콘텐츠에 대한 액세스 권한을 부여하지 않습니다.
기능 지원
Vertex에서 현재 지원되는 모든 기능은 여기에서 찾을 수 있습니다.