Vertex AI API 개요

이 페이지에서는 Google Distributed Cloud (GDC) 에어갭에서 Vertex AI와 함께 설치된 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 또는 snake_case를 허용합니다.
  • REST 및 gRPC 필드 이름은 snake_case를 사용합니다.
  • 클라이언트 라이브러리 필드 이름은 어떤 이름이 해당 언어에 자연스러운지에 따라 타이틀 표기법, 카멜 표기법, 스네이크 표기법 중 하나를 사용합니다.

REST 및 프로토콜 버퍼

REST API를 호출할 때 프로토콜 버퍼의 기본값 동작으로 인해 JSON 응답에서 필드가 누락될 수 있습니다. 이러한 필드는 기본값으로 설정되므로 응답에 포함되지 않습니다.