Google Distributed Cloud(GDC) 에어 갭의 Vertex AI API를 사용하면 선행 학습된 머신러닝 모델을 애플리케이션에 프로그래매틱 방식으로 통합하고 Vertex AI Workbench 리소스를 관리할 수 있습니다. 서비스에 따라 gRPC, REST, Python 클라이언트 라이브러리 또는 Kubernetes 리소스 모델(KRM)을 사용하여 이러한 API와 상호작용할 수 있습니다.
서비스 엔드포인트 및 탐색 문서
Vertex AI API와 프로그래매틱 방식으로 상호작용하려면 서비스 엔드포인트가 필요합니다.
Vertex AI Workbench 엔드포인트 및 탐색 문서 가져오기
Vertex AI Workbench KRM API의 API 엔드포인트는 다음과 같습니다.
https://ENDPOINT/apis/aiplatform.gdc.goog/v1
ENDPOINT를 Management API 서버의 API 엔드포인트로 바꿉니다.
Vertex AI Workbench 탐색 문서에 액세스하려면 다음 작업 중 하나를 수행합니다.
브라우저에 엔드포인트 URL을 입력합니다.
curl과 같은 도구에서
kubectl proxy명령어를 실행하여 로컬 머신의 Management API 서버에 대한 프록시를 엽니다. 이 명령어가 실행되면 브라우저에 다음 URL을 입력합니다.http://127.0.0.1:8001/apis/aiplatform.gdc.goog/v1개
사전 학습된 API 엔드포인트 가져오기
사전 학습된 API의 엔드포인트를 가져오려면 서비스 상태 및 엔드포인트를 확인하세요.
REST, gRPC, KRM, 클라이언트 라이브러리
gRPC 또는 제공된 클라이언트 라이브러리 중 하나를 사용하여 선행 학습된 API에 액세스할 수 있습니다. 클라이언트 라이브러리는 gRPC를 기반으로 빌드됩니다.
또는 REST를 사용하여 선행 학습된 API에 액세스합니다.
Kubernetes 리소스 모델(KRM) API를 사용하여 Vertex AI Workbench를 관리할 수 있습니다.
클라이언트 라이브러리
Vertex AI는 사전 학습된 API를 위한 Python 클라이언트 라이브러리를 제공합니다. 다음 표에서는 클라이언트 라이브러리 사용의 장단점을 비교합니다.
| 장점 | 단점 |
|---|---|
|
Google이 관리
인증 기능 내장 기본 제공 재시도 효율적인 프로토콜 버퍼 HTTP 요청 본문입니다. |
일부 프로그래밍 언어에서는 사용할 수 없습니다. |
REST
OCR 및 Translation API는 REST를 지원합니다. 자세한 내용은 다음 서비스의 REST API 참조를 확인하세요.
다음 표에서는 REST 사용의 장단점을 비교해서 보여줍니다.
| 장점 | 단점 |
|---|---|
|
간단한 JSON 인터페이스
다양한 Google 및 타사 도구 및 라이브러리에서 지원 |
자체 클라이언트 빌드 필요
인증을 구현해야 합니다. 재시도를 구현해야 합니다. 비효율적인 JSON HTTP 요청 본문 이러한 API는 REST 스트리밍을 지원하지 않습니다. |
gRPC
선행 학습된 API는 gRPC를 지원합니다. gRPC 라이브러리에 대해 생성된 유형, 메서드, 필드의 일반적인 설명에 대한 자세한 내용은 다음 gRPC 참조를 확인하세요.
다음 표에서는 gRPC 사용의 장점과 단점을 비교합니다.
| 장점 | 단점 |
|---|---|
|
다양한 프로그래밍 언어를 지원합니다.
효율적인 프로토콜 버퍼 HTTP 요청 본문입니다. |
Google에서 제공하는 프로토콜 버퍼에서 자체 클라이언트 생성 필요
인증을 구현해야 합니다. 재시도를 구현해야 합니다. |
KRM
Vertex AI Workbench API는 KRM을 지원합니다. 자세한 내용은 Vertex AI Workbench KRM API 참조를 확인하세요.
유형, 메서드, 필드 이름
클라이언트 라이브러리, REST, gRPC, KRM 중 무엇을 사용하는지에 따라 API의 유형, 메서드, 필드 이름이 다음과 같이 달라집니다.
- REST는 리소스 계층 구조와 해당 메서드로 정렬됩니다.
- 클라이언트 라이브러리와 gRPC는 서비스 및 메서드별로 정렬됩니다.
- KRM 필드 이름은 camelCase를 사용하지만 API 서비스는 camelCase 또는 스네이크 표기법을 허용합니다.
- REST 및 gRPC 필드 이름은 스네이크 표기법을 사용합니다.
- 클라이언트 라이브러리 필드 이름은 언어에 따라 제목 대소문자, camelCase 또는 스네이크 표기법을 사용합니다.
REST 및 프로토콜 버퍼
REST API를 호출할 때 프로토콜 버퍼의 기본값 동작으로 인해 JSON 응답에 필드가 누락될 수 있습니다. 이러한 필드는 기본값으로 설정되므로 응답에 포함되지 않습니다.